@unional/async-context 2.0.0 → 3.0.0

package/README.md

@@ -1,19 +1,17 @@
-# @unional/async-context
+# `@unional/async-context`
 
 [![NPM version][npm-image]][npm-url]
 [![NPM downloads][downloads-image]][downloads-url]
 [![Bundle size][bundlephobia-image]][bundlephobia-url]
 
 [![Codecov][codecov-image]][codecov-url]
-[![Codacy Grade Badge][codacy-grade]][codacy-grade-url]
-[![Codacy Coverage Badge][codacy-coverage]][codacy-coverage-url]
 
 Secure, type safe, asynchronous context for functional programming.
 
 In functional programming,
 it is common to pass in a context object containing dependencies used by the function.
 
-`AsyncContext` allow these dependencies to be loaded asynchronously.
+`AsyncContext` allows these dependencies to be loaded asynchronously.
 
 This is useful in many cases. For example,
 
@@ -24,52 +22,69 @@ This is useful in many cases. For example,
 
 ## Installation
 
+This is part of [`async-fp`](../async-fp/README.md).
+
+Typically, you will install that instead of installing `@unional/async-context` directly.
+
+But if you want, you can:
+
 ```sh
+# npm
 npm install @unional/async-context
-# or
+
+# yarn
 yarn add @unional/async-context
+
+# pnpm
+pnpm install @unional/async-context
+
+#rush
+rush add -p @unional/async-context
 ```
 
 ## Usage
 
+You can provide the initial context when calling the constructor.
+The context value must be an object (`Record`).
+You can extend and augment the context with the [`extend()`](#extend) later.
+
+You can supply the context value in 4 different ways:
+
 ```ts
 import { AsyncContext } from '@unional/async-context'
 
-const context = new AsyncContext({ key: 'secret key' })
-const context = new AsyncContext(Promise.resolve({ key: 'secret key' }))
-const context = new AsyncContext(() => ({ key: 'secret key' }))
+const context = new AsyncContext({ key: 'secret key' }) // or
+const context = new AsyncContext(Promise.resolve({ key: 'secret key' })) // or
+const context = new AsyncContext(() => ({ key: 'secret key' })) // or
 const context = new AsyncContext(async () => ({ key: 'secret key' }))
 
 await context.get() // => { key: 'secret key' }
 ```
 
-The context value must be an object (`Record`).
-This allows the context to be [extended](#extend).
-
-If you provide a handler,
-it will not be executed until the first `context.get()` is called.
-It allows you to wait for user input and change the value/dependency loaded.
+If you provide an initialize function,
+it will not be executed until the `context.get()` is called.
+It allows you to wait for user input and change the values/dependencies loaded.
 
 If you want to start loading the dependencies immediately,
-starts the loading and pass in a `Promise`.
+starts the loading and pass in the resulting `Promise`.
 
 ### Initialize
 
-You can create an `AsyncContext` and initialize it later.
+You can create a `AsyncContext` and initialize it later.
 This allows you to create a context in one part of your system,
-and initialize it in another part.
+and initialize it in another.
 
 ```ts
 import { AsyncContext } from '@unional/async-context'
 
-export const context = new AsyncContext<{ key: string }>()
+export const context = new AsyncContext<{ key: string }>() // optionally specify the init context type
 
 // in another file
 import { context } from './context'
 
-context.initialize({ key: 'secret key' })
-context.initialize(Promise.resolve({ key: 'secret key' }))
-context.initialize(() => ({ key: 'secret key' }))
+context.initialize({ key: 'secret key' }) // or
+context.initialize(Promise.resolve({ key: 'secret key' })) // or
+context.initialize(() => ({ key: 'secret key' })) // or
 context.initialize(() => Promise.resolve({ key: 'secret key' }))
 ```
 
@@ -83,7 +98,7 @@ you can use [`Object.freeze()`](https://developer.mozilla.org/en-US/docs/Web/Jav
 
 ### Extend
 
-You can extends a new context with new or override properties.
+You can extend or augment the context by calling `extend()`.
 
 ```ts
 import { AsyncContext } from '@unional/async-context'
@@ -98,6 +113,33 @@ const newCtx = ctx.extend(async () => ({ b: 2, c: 3 }))
 await newCtx.get() // => { a: 1, b: 2, c: 3 }
 ```
 
+The `extend()` updates the `AsyncContext` in place,
+i.e. the `newCtx` and `ctx` above is the same instance.
+
+The difference is that `newCtx` will have the context type updated while `ctx` doesn't.
+
+If you want to use the `ctx` directly, you can use `get<T>()` to assert the context type.
+
+```ts
+const ctx = new AsyncContext({ a: 1, b: 'b' })
+
+ctx.extend({ b: 2, c: 3 })
+await ctx.get<{ a: number, b: number, c: number }>()
+
+// it is really the same as this, but less verbose
+(await ctx.get() as { a: number, b: number, c: number })
+```
+
+### Chaining
+
+As you can guess, the `initialize()` and `extend()` functions can be chained:
+
+```ts
+const ctx = new AsyncContext()
+
+ctx.initialize({ a: 1 }).extend({ b: 2 }).extend({ c: 3 })
+```
+
 ## Use Cases
 
 ### Just-in-time Dependency Loading
@@ -166,15 +208,9 @@ configure({ ... })
 
 [bundlephobia-image]: https://img.shields.io/bundlephobia/minzip/@unional/async-context.svg
 [bundlephobia-url]: https://bundlephobia.com/result?p=@unional/async-context
-[codacy-grade]: https://api.codacy.com/project/badge/Grade/707f89609508442486050d207ec5bd78
-[codacy-grade-url]: https://www.codacy.com/app/homawong/async-fp?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=unional/async-fp&amp;utm_campaign=Badge_Grade
-[codacy-coverage]: https://api.codacy.com/project/badge/Coverage/707f89609508442486050d207ec5bd78
-[codacy-coverage-url]: https://www.codacy.com/manual/homawong/async-fp?utm_source=github.com&utm_medium=referral&utm_content=unional/async-fp&utm_campaign=Badge_Coverage
 [codecov-image]: https://codecov.io/gh/unional/async-fp/branch/master/graph/badge.svg
 [codecov-url]: https://codecov.io/gh/unional/async-fp
 [downloads-image]: https://img.shields.io/npm/dm/@unional/async-context.svg?style=flat
 [downloads-url]: https://npmjs.org/package/@unional/async-context
-[github-nodejs]: https://github.com/unional/async-fp/workflows/Node%20CI/badge.svg
-[github-action-url]: https://github.com/unional/async-fp/actions
 [npm-image]: https://img.shields.io/npm/v/@unional/async-context.svg?style=flat
 [npm-url]: https://npmjs.org/package/@unional/async-context

package/cjs/AsyncContext.d.ts

@@ -1,15 +1,17 @@
 import { LeftJoin } from 'type-plus';
-export declare class AsyncContext<T extends Record<string | symbol, any>> {
-    private context?;
-    private resolve;
+export declare class AsyncContext<Init extends Record<string | symbol, any>, Context extends Record<string | symbol, any> = Init> {
+    #private;
+    private init?;
+    private transformers;
     private resolving;
-    constructor(context?: T | Promise<T> | AsyncContext.Initializer<T> | undefined);
-    get(): Promise<T>;
-    initialize(context: T | Promise<T> | AsyncContext.Initializer<T>): void;
-    extend<R extends Record<string | symbol, any>>(context: R | Promise<R> | AsyncContext.Transformer<T, R>): AsyncContext<LeftJoin<T, R>>;
+    private resolve;
+    constructor(init?: Init | Promise<Init> | AsyncContext.Initializer<Init> | undefined);
+    initialize<I extends Init = Init>(init: I | Promise<I> | AsyncContext.Initializer<I>): AsyncContext<I>;
+    extend<R extends Record<string | symbol, any>>(context: R | Promise<R> | AsyncContext.Transformer<Context, R>): AsyncContext<Init, LeftJoin<Context, R>>;
+    get<C = Context>(): Promise<C>;
 }
 export declare namespace AsyncContext {
-    type Initializer<T> = () => T | Promise<T>;
-    type Transformer<T, R> = (context: AsyncContext<T>) => R | Promise<R>;
+    type Initializer<Init> = () => Init | Promise<Init>;
+    type Transformer<CurrentContext, AdditionalContext> = (context: CurrentContext) => AdditionalContext | Promise<AdditionalContext>;
 }
 //# sourceMappingURL=AsyncContext.d.ts.map

package/cjs/AsyncContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncContext.d.ts","sourceRoot":"","sources":["../ts/AsyncContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAGpC,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC;IAGlD,OAAO,CAAC,OAAO,CAAC;IAF5B,OAAO,CAAC,OAAO,CAAmD;IAClE,OAAO,CAAC,SAAS,CAAwB;gBACrB,OAAO,CAAC,0DAA8C;IACpE,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC;IAMvB,UAAU,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC;IAKhE,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAQvI;AAED,yBAAiB,YAAY,CAAC;IAC5B,KAAY,WAAW,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACjD,KAAY,WAAW,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAC7E"}
+{"version":3,"file":"AsyncContext.d.ts","sourceRoot":"","sources":["../ts/AsyncContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAGpC,qBAAa,YAAY,CACvB,IAAI,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EACzC,OAAO,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;;IAKvC,OAAO,CAAC,IAAI,CAAC;IAHzB,OAAO,CAAC,YAAY,CAAgD;IACpE,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,OAAO,CAA6D;gBACxD,IAAI,CAAC,mEAAuD;IAChF,UAAU,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IAOtG,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAC3C,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,GAC7D,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAIrC,GAAG,CAAC,CAAC,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC;CAUrC;AACD,yBAAiB,YAAY,CAAC;IAC5B,KAAY,WAAW,CAAC,IAAI,IAAI,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1D,KAAY,WAAW,CACrB,cAAc,EACd,iBAAiB,IACb,CAAC,OAAO,EAAE,cAAc,KAAK,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;CAClF"}

package/cjs/AsyncContext.js

@@ -1,67 +1,27 @@
 "use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (_) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
+var _AsyncContext_instances, _AsyncContext_buildContext;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AsyncContext = void 0;
-var errors_1 = require("./errors");
-var AsyncContext = /** @class */ (function () {
-    function AsyncContext(context) {
-        Object.defineProperty(this, "context", {
+const errors_1 = require("./errors");
+class AsyncContext {
+    constructor(init) {
+        _AsyncContext_instances.add(this);
+        Object.defineProperty(this, "init", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: context
+            value: init
         });
-        Object.defineProperty(this, "resolve", {
+        Object.defineProperty(this, "transformers", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: []
         });
         Object.defineProperty(this, "resolving", {
             enumerable: true,
@@ -69,66 +29,40 @@ var AsyncContext = /** @class */ (function () {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "resolve", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: undefined
+        });
+    }
+    initialize(init) {
+        if (this.init)
+            throw new errors_1.ContextAlreadyInitialized();
+        this.init = init;
+        if (this.resolve)
+            this.resolve(__classPrivateFieldGet(this, _AsyncContext_instances, "m", _AsyncContext_buildContext).call(this));
+        return this;
+    }
+    extend(context) {
+        this.transformers.push(isTransformer(context) ? context : () => context);
+        return this;
+    }
+    async get() {
+        if (this.resolving)
+            return this.resolving;
+        return this.resolving = this.init ? __classPrivateFieldGet(this, _AsyncContext_instances, "m", _AsyncContext_buildContext).call(this) : new Promise(a => this.resolve = a);
     }
-    Object.defineProperty(AsyncContext.prototype, "get", {
-        enumerable: false,
-        configurable: true,
-        writable: true,
-        value: function () {
-            return __awaiter(this, void 0, void 0, function () {
-                var _this = this;
-                return __generator(this, function (_a) {
-                    if (this.resolving)
-                        return [2 /*return*/, this.resolving];
-                    return [2 /*return*/, this.resolving = this.context
-                            ? Promise.resolve(initContext(this.context))
-                            : new Promise(function (a) { return _this.resolve = a; })];
-                });
-            });
-        }
-    });
-    Object.defineProperty(AsyncContext.prototype, "initialize", {
-        enumerable: false,
-        configurable: true,
-        writable: true,
-        value: function (context) {
-            if (this.context)
-                throw new errors_1.ContextAlreadyInitialized();
-            this.context = context;
-            if (this.resolve)
-                this.resolve(initContext(context));
-        }
-    });
-    Object.defineProperty(AsyncContext.prototype, "extend", {
-        enumerable: false,
-        configurable: true,
-        writable: true,
-        value: function (context) {
-            var _this = this;
-            return new AsyncContext(function () { return __awaiter(_this, void 0, void 0, function () {
-                var current, next;
-                return __generator(this, function (_a) {
-                    switch (_a.label) {
-                        case 0: return [4 /*yield*/, this.get()];
-                        case 1:
-                            current = _a.sent();
-                            return [4 /*yield*/, transformContext(context, this)];
-                        case 2:
-                            next = _a.sent();
-                            return [2 /*return*/, __assign(__assign({}, current), next)];
-                    }
-                });
-            }); });
-        }
-    });
-    return AsyncContext;
-}());
-exports.AsyncContext = AsyncContext;
-function initContext(context) {
-    return isInitializer(context) ? context() : context;
 }
-function transformContext(context, currentContext) {
-    return isTransformer(context) ? context(currentContext) : context;
+exports.AsyncContext = AsyncContext;
+_AsyncContext_instances = new WeakSet(), _AsyncContext_buildContext = async function _AsyncContext_buildContext() {
+    return this.transformers.reduce(async (p, t) => {
+        const c = await p;
+        return { ...c, ...await t(c) };
+    }, resolveInit(this.init));
+};
+async function resolveInit(init) {
+    return isInitializer(init) ? init() : init;
 }
 function isTransformer(context) {
     return typeof context === 'function';

package/cjs/AsyncContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncContext.js","sourceRoot":"","sources":["../ts/AsyncContext.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,mCAAoD;AAEpD;IAGE,sBAAoB,OAAsD;;;;;mBAAtD;;QAFpB;;;;;WAAkE;QAClE;;;;;WAAyC;IACqC,CAAC;;;;;eAC/E;;;;oBACE,IAAI,IAAI,CAAC,SAAS;wBAAE,sBAAO,IAAI,CAAC,SAAS,EAAA;oBACzC,sBAAO,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO;4BAClC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;4BAC5C,CAAC,CAAC,IAAI,OAAO,CAAI,UAAA,CAAC,IAAI,OAAA,KAAI,CAAC,OAAO,GAAG,CAAC,EAAhB,CAAgB,CAAC,EAAA;;;SAC1C;;;;;;eACD,UAAW,OAAqD;YAC9D,IAAI,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,kCAAyB,EAAE,CAAA;YACvD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;YACtB,IAAI,IAAI,CAAC,OAAO;gBAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;QACtD,CAAC;;;;;;eACD,UAA+C,OAAwD;YAAvG,iBAOC;YANC,OAAO,IAAI,YAAY,CAAC;;;;gCACN,qBAAM,IAAI,CAAC,GAAG,EAAE,EAAA;;4BAA1B,OAAO,GAAG,SAAgB;4BACnB,qBAAM,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,EAAA;;4BAA5C,IAAI,GAAG,SAAqC;4BAElD,sBAAO,sBAAK,OAAO,GAAK,IAAI,CAAoB,EAAA;;;iBACjD,CAAC,CAAA;QACJ,CAAC;;IACH,mBAAC;AAAD,CAAC,AAvBD,IAuBC;AAvBY,oCAAY;AA8BzB,SAAS,WAAW,CAEhB,OAAqD;IACvD,OAAO,aAAa,CAAI,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;AACxD,CAAC;AAED,SAAS,gBAAgB,CAGvB,OAAwD,EAAE,cAA+B;IACzF,OAAO,aAAa,CAAO,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;AACzE,CAAC;AAED,SAAS,aAAa,CAAO,OAAY;IACvC,OAAO,OAAO,OAAO,KAAK,UAAU,CAAA;AACtC,CAAC;AAED,SAAS,aAAa,CAAI,OAAY;IACpC,OAAO,OAAO,OAAO,KAAK,UAAU,CAAA;AACtC,CAAC","sourcesContent":["import { LeftJoin } from 'type-plus'\nimport { ContextAlreadyInitialized } from './errors'\n\nexport class AsyncContext<T extends Record<string | symbol, any>> {\n  private resolve: ((value: T | PromiseLike<T>) => void) | undefined\n  private resolving: Promise<T> | undefined\n  constructor(private context?: T | Promise<T> | AsyncContext.Initializer<T>) { }\n  async get(): Promise<T> {\n    if (this.resolving) return this.resolving\n    return this.resolving = this.context\n      ? Promise.resolve(initContext(this.context))\n      : new Promise<T>(a => this.resolve = a)\n  }\n  initialize(context: T | Promise<T> | AsyncContext.Initializer<T>) {\n    if (this.context) throw new ContextAlreadyInitialized()\n    this.context = context\n    if (this.resolve) this.resolve(initContext(context))\n  }\n  extend<R extends Record<string | symbol, any>>(context: R | Promise<R> | AsyncContext.Transformer<T, R>): AsyncContext<LeftJoin<T, R>> {\n    return new AsyncContext(async () => {\n      const current = await this.get()\n      const next = await transformContext(context, this)\n\n      return { ...current, ...next } as LeftJoin<T, R>\n    })\n  }\n}\n\nexport namespace AsyncContext {\n  export type Initializer<T> = () => T | Promise<T>\n  export type Transformer<T, R> = (context: AsyncContext<T>) => R | Promise<R>\n}\n\nfunction initContext<\n  T extends Record<string | symbol, any>,\n  >(context: T | Promise<T> | AsyncContext.Initializer<T>): T | Promise<T> {\n  return isInitializer<T>(context) ? context() : context\n}\n\nfunction transformContext<\n  T extends Record<string | symbol, any>,\n  R extends Record<string | symbol, any>\n>(context: R | Promise<R> | AsyncContext.Transformer<T, R>, currentContext: AsyncContext<T>): R | Promise<R> {\n  return isTransformer<T, R>(context) ? context(currentContext) : context\n}\n\nfunction isTransformer<T, R>(context: any): context is AsyncContext.Transformer<T, R> {\n  return typeof context === 'function'\n}\n\nfunction isInitializer<T>(context: any): context is AsyncContext.Initializer<T> {\n  return typeof context === 'function'\n}\n"]}
+{"version":3,"file":"AsyncContext.js","sourceRoot":"","sources":["../ts/AsyncContext.ts"],"names":[],"mappings":";;;;;;;;;AACA,qCAAoD;AAEpD,MAAa,YAAY;IAOvB,YAAoB,IAA4D;;;;;;mBAA5D;;QAHpB;;;;mBAAkE,EAAE;WAAA;QACpE;;;;;WAA2C;QAC3C;;;;mBAAmE,SAAS;WAAA;IACQ,CAAC;IACrF,UAAU,CAAwB,IAAkD;QAClF,IAAI,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,kCAAyB,EAAE,CAAA;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAEhB,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,CAAC,uBAAA,IAAI,2DAAc,MAAlB,IAAI,CAAgB,CAAC,CAAA;QACpD,OAAO,IAAuB,CAAA;IAChC,CAAC;IACD,MAAM,CACJ,OAA8D;QAE9D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAA;QACxE,OAAO,IAAgD,CAAA;IACzD,CAAC;IACD,KAAK,CAAC,GAAG;QACP,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAA;QACzC,OAAO,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,uBAAA,IAAI,2DAAc,MAAlB,IAAI,CAAgB,CAAC,CAAC,CAAC,IAAI,OAAO,CAAM,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAA;IACpG,CAAC;CAOF;AA/BD,oCA+BC;sEANC,KAAK;IACH,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;QAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAA;QACjB,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAQ,EAAE,CAAA;IACvC,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,IAAK,CAAC,CAAqB,CAAA;AACjD,CAAC;AAUH,KAAK,UAAU,WAAW,CAEtB,IAA2D;IAC7D,OAAO,aAAa,CAAO,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAClD,CAAC;AAED,SAAS,aAAa,CAGpB,OAAgB;IAChB,OAAO,OAAO,OAAO,KAAK,UAAU,CAAA;AACtC,CAAC;AAED,SAAS,aAAa,CAAI,OAAgB;IACxC,OAAO,OAAO,OAAO,KAAK,UAAU,CAAA;AACtC,CAAC","sourcesContent":["import { LeftJoin } from 'type-plus'\nimport { ContextAlreadyInitialized } from './errors'\n\nexport class AsyncContext<\n  Init extends Record<string | symbol, any>,\n  Context extends Record<string | symbol, any> = Init\n  > {\n  private transformers: Array<AsyncContext.Transformer<any, any>> = []\n  private resolving: Promise<any> | undefined\n  private resolve: ((value: Promise<Context>) => void) | undefined = undefined\n  constructor(private init?: Init | Promise<Init> | AsyncContext.Initializer<Init>) { }\n  initialize<I extends Init = Init>(init: I | Promise<I> | AsyncContext.Initializer<I>): AsyncContext<I> {\n    if (this.init) throw new ContextAlreadyInitialized()\n    this.init = init\n\n    if (this.resolve) this.resolve(this.#buildContext())\n    return this as AsyncContext<I>\n  }\n  extend<R extends Record<string | symbol, any>>(\n    context: R | Promise<R> | AsyncContext.Transformer<Context, R>\n  ): AsyncContext<Init, LeftJoin<Context, R>> {\n    this.transformers.push(isTransformer(context) ? context : () => context)\n    return this as AsyncContext<Init, LeftJoin<Context, R>>\n  }\n  async get<C = Context>(): Promise<C> {\n    if (this.resolving) return this.resolving\n    return this.resolving = this.init ? this.#buildContext() : new Promise<any>(a => this.resolve = a)\n  }\n  async #buildContext(): Promise<Context> {\n    return this.transformers.reduce(async (p, t) => {\n      const c = await p\n      return { ...c, ...await t(c) as any }\n    }, resolveInit(this.init!)) as Promise<Context>\n  }\n}\nexport namespace AsyncContext {\n  export type Initializer<Init> = () => Init | Promise<Init>\n  export type Transformer<\n    CurrentContext,\n    AdditionalContext\n    > = (context: CurrentContext) => AdditionalContext | Promise<AdditionalContext>\n}\n\nasync function resolveInit<\n  Init extends Record<string | symbol, any>,\n  >(init: Init | Promise<Init> | AsyncContext.Initializer<Init>): Promise<Init> {\n  return isInitializer<Init>(init) ? init() : init\n}\n\nfunction isTransformer<\n  CurrentContext,\n  AdditionalContext\n>(context: unknown): context is AsyncContext.Transformer<CurrentContext, AdditionalContext> {\n  return typeof context === 'function'\n}\n\nfunction isInitializer<T>(context: unknown): context is AsyncContext.Initializer<T> {\n  return typeof context === 'function'\n}\n"]}

package/cjs/errors.js

@@ -1,28 +1,11 @@
 "use strict";
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ContextAlreadyInitialized = void 0;
-var iso_error_1 = require("iso-error");
-var ContextAlreadyInitialized = /** @class */ (function (_super) {
-    __extends(ContextAlreadyInitialized, _super);
-    function ContextAlreadyInitialized(options) {
-        return _super.call(this, '@unional/async-context', 'context can only be initialized once.', options) || this;
+const iso_error_1 = require("iso-error");
+class ContextAlreadyInitialized extends iso_error_1.ModuleError {
+    constructor(options) {
+        super('@unional/async-context', 'context can only be initialized once.', options);
     }
-    return ContextAlreadyInitialized;
-}(iso_error_1.ModuleError));
+}
 exports.ContextAlreadyInitialized = ContextAlreadyInitialized;
 //# sourceMappingURL=errors.js.map

package/cjs/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../ts/errors.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,uCAAiD;AAEjD;IAA+C,6CAAW;IACxD,mCAAY,OAA0B;eACpC,kBAAM,wBAAwB,EAAE,uCAAuC,EAAE,OAAO,CAAC;IACnF,CAAC;IACH,gCAAC;AAAD,CAAC,AAJD,CAA+C,uBAAW,GAIzD;AAJY,8DAAyB","sourcesContent":["import { IsoError, ModuleError } from 'iso-error'\n\nexport class ContextAlreadyInitialized extends ModuleError {\n  constructor(options?: IsoError.Options) {\n    super('@unional/async-context', 'context can only be initialized once.', options)\n  }\n}\n"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../ts/errors.ts"],"names":[],"mappings":";;;AAAA,yCAAiD;AAEjD,MAAa,yBAA0B,SAAQ,uBAAW;IACxD,YAAY,OAA0B;QACpC,KAAK,CAAC,wBAAwB,EAAE,uCAAuC,EAAE,OAAO,CAAC,CAAA;IACnF,CAAC;CACF;AAJD,8DAIC","sourcesContent":["import { IsoError, ModuleError } from 'iso-error'\n\nexport class ContextAlreadyInitialized extends ModuleError {\n  constructor(options?: IsoError.Options) {\n    super('@unional/async-context', 'context can only be initialized once.', options)\n  }\n}\n"]}

package/esm/AsyncContext.d.ts

@@ -1,15 +1,17 @@
 import { LeftJoin } from 'type-plus';
-export declare class AsyncContext<T extends Record<string | symbol, any>> {
-    private context?;
-    private resolve;
+export declare class AsyncContext<Init extends Record<string | symbol, any>, Context extends Record<string | symbol, any> = Init> {
+    #private;
+    private init?;
+    private transformers;
     private resolving;
-    constructor(context?: T | Promise<T> | AsyncContext.Initializer<T> | undefined);
-    get(): Promise<T>;
-    initialize(context: T | Promise<T> | AsyncContext.Initializer<T>): void;
-    extend<R extends Record<string | symbol, any>>(context: R | Promise<R> | AsyncContext.Transformer<T, R>): AsyncContext<LeftJoin<T, R>>;
+    private resolve;
+    constructor(init?: Init | Promise<Init> | AsyncContext.Initializer<Init> | undefined);
+    initialize<I extends Init = Init>(init: I | Promise<I> | AsyncContext.Initializer<I>): AsyncContext<I>;
+    extend<R extends Record<string | symbol, any>>(context: R | Promise<R> | AsyncContext.Transformer<Context, R>): AsyncContext<Init, LeftJoin<Context, R>>;
+    get<C = Context>(): Promise<C>;
 }
 export declare namespace AsyncContext {
-    type Initializer<T> = () => T | Promise<T>;
-    type Transformer<T, R> = (context: AsyncContext<T>) => R | Promise<R>;
+    type Initializer<Init> = () => Init | Promise<Init>;
+    type Transformer<CurrentContext, AdditionalContext> = (context: CurrentContext) => AdditionalContext | Promise<AdditionalContext>;
 }
 //# sourceMappingURL=AsyncContext.d.ts.map

package/esm/AsyncContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncContext.d.ts","sourceRoot":"","sources":["../ts/AsyncContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAGpC,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC;IAGlD,OAAO,CAAC,OAAO,CAAC;IAF5B,OAAO,CAAC,OAAO,CAAmD;IAClE,OAAO,CAAC,SAAS,CAAwB;gBACrB,OAAO,CAAC,0DAA8C;IACpE,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC;IAMvB,UAAU,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC;IAKhE,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAQvI;AAED,yBAAiB,YAAY,CAAC;IAC5B,KAAY,WAAW,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACjD,KAAY,WAAW,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAC7E"}
+{"version":3,"file":"AsyncContext.d.ts","sourceRoot":"","sources":["../ts/AsyncContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAGpC,qBAAa,YAAY,CACvB,IAAI,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EACzC,OAAO,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;;IAKvC,OAAO,CAAC,IAAI,CAAC;IAHzB,OAAO,CAAC,YAAY,CAAgD;IACpE,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,OAAO,CAA6D;gBACxD,IAAI,CAAC,mEAAuD;IAChF,UAAU,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IAOtG,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAC3C,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,GAC7D,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAIrC,GAAG,CAAC,CAAC,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC;CAUrC;AACD,yBAAiB,YAAY,CAAC;IAC5B,KAAY,WAAW,CAAC,IAAI,IAAI,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1D,KAAY,WAAW,CACrB,cAAc,EACd,iBAAiB,IACb,CAAC,OAAO,EAAE,cAAc,KAAK,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;CAClF"}

package/esm/AsyncContext.js

@@ -1,17 +1,24 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _AsyncContext_instances, _AsyncContext_buildContext;
 import { ContextAlreadyInitialized } from './errors';
 export class AsyncContext {
-    constructor(context) {
-        Object.defineProperty(this, "context", {
+    constructor(init) {
+        _AsyncContext_instances.add(this);
+        Object.defineProperty(this, "init", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: context
+            value: init
         });
-        Object.defineProperty(this, "resolve", {
+        Object.defineProperty(this, "transformers", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: void 0
+            value: []
         });
         Object.defineProperty(this, "resolving", {
             enumerable: true,
@@ -19,34 +26,39 @@ export class AsyncContext {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "resolve", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: undefined
+        });
     }
-    async get() {
-        if (this.resolving)
-            return this.resolving;
-        return this.resolving = this.context
-            ? Promise.resolve(initContext(this.context))
-            : new Promise(a => this.resolve = a);
-    }
-    initialize(context) {
-        if (this.context)
+    initialize(init) {
+        if (this.init)
             throw new ContextAlreadyInitialized();
-        this.context = context;
+        this.init = init;
         if (this.resolve)
-            this.resolve(initContext(context));
+            this.resolve(__classPrivateFieldGet(this, _AsyncContext_instances, "m", _AsyncContext_buildContext).call(this));
+        return this;
     }
     extend(context) {
-        return new AsyncContext(async () => {
-            const current = await this.get();
-            const next = await transformContext(context, this);
-            return { ...current, ...next };
-        });
+        this.transformers.push(isTransformer(context) ? context : () => context);
+        return this;
+    }
+    async get() {
+        if (this.resolving)
+            return this.resolving;
+        return this.resolving = this.init ? __classPrivateFieldGet(this, _AsyncContext_instances, "m", _AsyncContext_buildContext).call(this) : new Promise(a => this.resolve = a);
     }
 }
-function initContext(context) {
-    return isInitializer(context) ? context() : context;
-}
-function transformContext(context, currentContext) {
-    return isTransformer(context) ? context(currentContext) : context;
+_AsyncContext_instances = new WeakSet(), _AsyncContext_buildContext = async function _AsyncContext_buildContext() {
+    return this.transformers.reduce(async (p, t) => {
+        const c = await p;
+        return { ...c, ...await t(c) };
+    }, resolveInit(this.init));
+};
+async function resolveInit(init) {
+    return isInitializer(init) ? init() : init;
 }
 function isTransformer(context) {
     return typeof context === 'function';

package/esm/AsyncContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncContext.js","sourceRoot":"","sources":["../ts/AsyncContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAA;AAEpD,MAAM,OAAO,YAAY;IAGvB,YAAoB,OAAsD;;;;;mBAAtD;;QAFpB;;;;;WAAkE;QAClE;;;;;WAAyC;IACqC,CAAC;IAC/E,KAAK,CAAC,GAAG;QACP,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAA;QACzC,OAAO,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO;YAClC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5C,CAAC,CAAC,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAA;IAC3C,CAAC;IACD,UAAU,CAAC,OAAqD;QAC9D,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,yBAAyB,EAAE,CAAA;QACvD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;IACtD,CAAC;IACD,MAAM,CAAyC,OAAwD;QACrG,OAAO,IAAI,YAAY,CAAC,KAAK,IAAI,EAAE;YACjC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAA;YAChC,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;YAElD,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,EAAoB,CAAA;QAClD,CAAC,CAAC,CAAA;IACJ,CAAC;CACF;AAOD,SAAS,WAAW,CAEhB,OAAqD;IACvD,OAAO,aAAa,CAAI,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;AACxD,CAAC;AAED,SAAS,gBAAgB,CAGvB,OAAwD,EAAE,cAA+B;IACzF,OAAO,aAAa,CAAO,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;AACzE,CAAC;AAED,SAAS,aAAa,CAAO,OAAY;IACvC,OAAO,OAAO,OAAO,KAAK,UAAU,CAAA;AACtC,CAAC;AAED,SAAS,aAAa,CAAI,OAAY;IACpC,OAAO,OAAO,OAAO,KAAK,UAAU,CAAA;AACtC,CAAC","sourcesContent":["import { LeftJoin } from 'type-plus'\nimport { ContextAlreadyInitialized } from './errors'\n\nexport class AsyncContext<T extends Record<string | symbol, any>> {\n  private resolve: ((value: T | PromiseLike<T>) => void) | undefined\n  private resolving: Promise<T> | undefined\n  constructor(private context?: T | Promise<T> | AsyncContext.Initializer<T>) { }\n  async get(): Promise<T> {\n    if (this.resolving) return this.resolving\n    return this.resolving = this.context\n      ? Promise.resolve(initContext(this.context))\n      : new Promise<T>(a => this.resolve = a)\n  }\n  initialize(context: T | Promise<T> | AsyncContext.Initializer<T>) {\n    if (this.context) throw new ContextAlreadyInitialized()\n    this.context = context\n    if (this.resolve) this.resolve(initContext(context))\n  }\n  extend<R extends Record<string | symbol, any>>(context: R | Promise<R> | AsyncContext.Transformer<T, R>): AsyncContext<LeftJoin<T, R>> {\n    return new AsyncContext(async () => {\n      const current = await this.get()\n      const next = await transformContext(context, this)\n\n      return { ...current, ...next } as LeftJoin<T, R>\n    })\n  }\n}\n\nexport namespace AsyncContext {\n  export type Initializer<T> = () => T | Promise<T>\n  export type Transformer<T, R> = (context: AsyncContext<T>) => R | Promise<R>\n}\n\nfunction initContext<\n  T extends Record<string | symbol, any>,\n  >(context: T | Promise<T> | AsyncContext.Initializer<T>): T | Promise<T> {\n  return isInitializer<T>(context) ? context() : context\n}\n\nfunction transformContext<\n  T extends Record<string | symbol, any>,\n  R extends Record<string | symbol, any>\n>(context: R | Promise<R> | AsyncContext.Transformer<T, R>, currentContext: AsyncContext<T>): R | Promise<R> {\n  return isTransformer<T, R>(context) ? context(currentContext) : context\n}\n\nfunction isTransformer<T, R>(context: any): context is AsyncContext.Transformer<T, R> {\n  return typeof context === 'function'\n}\n\nfunction isInitializer<T>(context: any): context is AsyncContext.Initializer<T> {\n  return typeof context === 'function'\n}\n"]}
+{"version":3,"file":"AsyncContext.js","sourceRoot":"","sources":["../ts/AsyncContext.ts"],"names":[],"mappings":";;;;;;AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAA;AAEpD,MAAM,OAAO,YAAY;IAOvB,YAAoB,IAA4D;;;;;;mBAA5D;;QAHpB;;;;mBAAkE,EAAE;WAAA;QACpE;;;;;WAA2C;QAC3C;;;;mBAAmE,SAAS;WAAA;IACQ,CAAC;IACrF,UAAU,CAAwB,IAAkD;QAClF,IAAI,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,yBAAyB,EAAE,CAAA;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAEhB,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,CAAC,uBAAA,IAAI,2DAAc,MAAlB,IAAI,CAAgB,CAAC,CAAA;QACpD,OAAO,IAAuB,CAAA;IAChC,CAAC;IACD,MAAM,CACJ,OAA8D;QAE9D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAA;QACxE,OAAO,IAAgD,CAAA;IACzD,CAAC;IACD,KAAK,CAAC,GAAG;QACP,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAA;QACzC,OAAO,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,uBAAA,IAAI,2DAAc,MAAlB,IAAI,CAAgB,CAAC,CAAC,CAAC,IAAI,OAAO,CAAM,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAA;IACpG,CAAC;CAOF;sEANC,KAAK;IACH,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;QAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAA;QACjB,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAQ,EAAE,CAAA;IACvC,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,IAAK,CAAC,CAAqB,CAAA;AACjD,CAAC;AAUH,KAAK,UAAU,WAAW,CAEtB,IAA2D;IAC7D,OAAO,aAAa,CAAO,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAClD,CAAC;AAED,SAAS,aAAa,CAGpB,OAAgB;IAChB,OAAO,OAAO,OAAO,KAAK,UAAU,CAAA;AACtC,CAAC;AAED,SAAS,aAAa,CAAI,OAAgB;IACxC,OAAO,OAAO,OAAO,KAAK,UAAU,CAAA;AACtC,CAAC","sourcesContent":["import { LeftJoin } from 'type-plus'\nimport { ContextAlreadyInitialized } from './errors'\n\nexport class AsyncContext<\n  Init extends Record<string | symbol, any>,\n  Context extends Record<string | symbol, any> = Init\n  > {\n  private transformers: Array<AsyncContext.Transformer<any, any>> = []\n  private resolving: Promise<any> | undefined\n  private resolve: ((value: Promise<Context>) => void) | undefined = undefined\n  constructor(private init?: Init | Promise<Init> | AsyncContext.Initializer<Init>) { }\n  initialize<I extends Init = Init>(init: I | Promise<I> | AsyncContext.Initializer<I>): AsyncContext<I> {\n    if (this.init) throw new ContextAlreadyInitialized()\n    this.init = init\n\n    if (this.resolve) this.resolve(this.#buildContext())\n    return this as AsyncContext<I>\n  }\n  extend<R extends Record<string | symbol, any>>(\n    context: R | Promise<R> | AsyncContext.Transformer<Context, R>\n  ): AsyncContext<Init, LeftJoin<Context, R>> {\n    this.transformers.push(isTransformer(context) ? context : () => context)\n    return this as AsyncContext<Init, LeftJoin<Context, R>>\n  }\n  async get<C = Context>(): Promise<C> {\n    if (this.resolving) return this.resolving\n    return this.resolving = this.init ? this.#buildContext() : new Promise<any>(a => this.resolve = a)\n  }\n  async #buildContext(): Promise<Context> {\n    return this.transformers.reduce(async (p, t) => {\n      const c = await p\n      return { ...c, ...await t(c) as any }\n    }, resolveInit(this.init!)) as Promise<Context>\n  }\n}\nexport namespace AsyncContext {\n  export type Initializer<Init> = () => Init | Promise<Init>\n  export type Transformer<\n    CurrentContext,\n    AdditionalContext\n    > = (context: CurrentContext) => AdditionalContext | Promise<AdditionalContext>\n}\n\nasync function resolveInit<\n  Init extends Record<string | symbol, any>,\n  >(init: Init | Promise<Init> | AsyncContext.Initializer<Init>): Promise<Init> {\n  return isInitializer<Init>(init) ? init() : init\n}\n\nfunction isTransformer<\n  CurrentContext,\n  AdditionalContext\n>(context: unknown): context is AsyncContext.Transformer<CurrentContext, AdditionalContext> {\n  return typeof context === 'function'\n}\n\nfunction isInitializer<T>(context: unknown): context is AsyncContext.Initializer<T> {\n  return typeof context === 'function'\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unional/async-context",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "Asynchronous context for functional style programming",
   "keywords": [
     "async",
@@ -39,7 +39,7 @@
   },
   "devDependencies": {
     "@size-limit/preset-small-lib": "^8.0.1",
-    "@types/node": "^14.18.23",
+    "@types/node": "^16.0.0",
     "@typescript-eslint/eslint-plugin": "^5.33.0",
     "@typescript-eslint/parser": "^5.33.0",
     "assertron": "^10.0.0",

package/ts/AsyncContext.ts

@@ -1,53 +1,59 @@
 import { LeftJoin } from 'type-plus'
 import { ContextAlreadyInitialized } from './errors'
 
-export class AsyncContext<T extends Record<string | symbol, any>> {
-  private resolve: ((value: T | PromiseLike<T>) => void) | undefined
-  private resolving: Promise<T> | undefined
-  constructor(private context?: T | Promise<T> | AsyncContext.Initializer<T>) { }
-  async get(): Promise<T> {
-    if (this.resolving) return this.resolving
-    return this.resolving = this.context
-      ? Promise.resolve(initContext(this.context))
-      : new Promise<T>(a => this.resolve = a)
+export class AsyncContext<
+  Init extends Record<string | symbol, any>,
+  Context extends Record<string | symbol, any> = Init
+  > {
+  private transformers: Array<AsyncContext.Transformer<any, any>> = []
+  private resolving: Promise<any> | undefined
+  private resolve: ((value: Promise<Context>) => void) | undefined = undefined
+  constructor(private init?: Init | Promise<Init> | AsyncContext.Initializer<Init>) { }
+  initialize<I extends Init = Init>(init: I | Promise<I> | AsyncContext.Initializer<I>): AsyncContext<I> {
+    if (this.init) throw new ContextAlreadyInitialized()
+    this.init = init
+
+    if (this.resolve) this.resolve(this.#buildContext())
+    return this as AsyncContext<I>
   }
-  initialize(context: T | Promise<T> | AsyncContext.Initializer<T>) {
-    if (this.context) throw new ContextAlreadyInitialized()
-    this.context = context
-    if (this.resolve) this.resolve(initContext(context))
+  extend<R extends Record<string | symbol, any>>(
+    context: R | Promise<R> | AsyncContext.Transformer<Context, R>
+  ): AsyncContext<Init, LeftJoin<Context, R>> {
+    this.transformers.push(isTransformer(context) ? context : () => context)
+    return this as AsyncContext<Init, LeftJoin<Context, R>>
   }
-  extend<R extends Record<string | symbol, any>>(context: R | Promise<R> | AsyncContext.Transformer<T, R>): AsyncContext<LeftJoin<T, R>> {
-    return new AsyncContext(async () => {
-      const current = await this.get()
-      const next = await transformContext(context, this)
-
-      return { ...current, ...next } as LeftJoin<T, R>
-    })
+  async get<C = Context>(): Promise<C> {
+    if (this.resolving) return this.resolving
+    return this.resolving = this.init ? this.#buildContext() : new Promise<any>(a => this.resolve = a)
+  }
+  async #buildContext(): Promise<Context> {
+    return this.transformers.reduce(async (p, t) => {
+      const c = await p
+      return { ...c, ...await t(c) as any }
+    }, resolveInit(this.init!)) as Promise<Context>
   }
 }
-
 export namespace AsyncContext {
-  export type Initializer<T> = () => T | Promise<T>
-  export type Transformer<T, R> = (context: AsyncContext<T>) => R | Promise<R>
-}
-
-function initContext<
-  T extends Record<string | symbol, any>,
-  >(context: T | Promise<T> | AsyncContext.Initializer<T>): T | Promise<T> {
-  return isInitializer<T>(context) ? context() : context
+  export type Initializer<Init> = () => Init | Promise<Init>
+  export type Transformer<
+    CurrentContext,
+    AdditionalContext
+    > = (context: CurrentContext) => AdditionalContext | Promise<AdditionalContext>
 }
 
-function transformContext<
-  T extends Record<string | symbol, any>,
-  R extends Record<string | symbol, any>
->(context: R | Promise<R> | AsyncContext.Transformer<T, R>, currentContext: AsyncContext<T>): R | Promise<R> {
-  return isTransformer<T, R>(context) ? context(currentContext) : context
+async function resolveInit<
+  Init extends Record<string | symbol, any>,
+  >(init: Init | Promise<Init> | AsyncContext.Initializer<Init>): Promise<Init> {
+  return isInitializer<Init>(init) ? init() : init
 }
 
-function isTransformer<T, R>(context: any): context is AsyncContext.Transformer<T, R> {
+function isTransformer<
+  CurrentContext,
+  AdditionalContext
+>(context: unknown): context is AsyncContext.Transformer<CurrentContext, AdditionalContext> {
   return typeof context === 'function'
 }
 
-function isInitializer<T>(context: any): context is AsyncContext.Initializer<T> {
+function isInitializer<T>(context: unknown): context is AsyncContext.Initializer<T> {
   return typeof context === 'function'
 }