type-plus 4.15.2 → 4.16.0

package/README.md

@@ -368,12 +368,15 @@ JSONTypes.get<string>(someJson, 'a', 'b', 1, 'c') // miku
 - `SpreadRecord<A, B>`: type for `{...a, ...b}` when both `a` and `b` are `Record`\
   for array, just do `[...A, ...B]`.
 
-### Promise function
+### Promise utilities
 
 - `isPromise<R>(subject: any)`: `isPromise()` type guard.
+- `MaybePromise<T>`: Alias of `T | Promise<T>`.
 - `PromiseValue<P>`: Gets the type within the Promise.
 - `PromiseValueMerge<P1, P2, ...P9>`: Merge the values of multiple promises.
 - `mapSeries()`: Similar to `bluebird.mapSeries()` but works with `async`/`await`.
+- `transformMaybePromise(value, transformer)`: Apply the `transformer` to the `value`.\
+  It is also exported under `MaybePromise.transform()`.
 
 ### Type manipulation
 

package/cjs/promise/MaybePromise.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `T | Promise<T>`
+ */
+export declare type MaybePromise<T> = T | Promise<T>;
+/**
+ * Transforms the value within the promise.
+ *
+ * @return a new promise with the transformed result.
+ */
+export declare function transformMaybePromise<T, R>(value: Promise<T>, transformer: (value: T) => R): Promise<R>;
+/**
+ * Transforms the value, or if the value is a promise,
+ * transform the resolved value of the promise.
+ *
+ * @return the transformed result,
+ * or if the value is a promise, a new promse with the transformed result.
+ */
+export declare function transformMaybePromise<T, R>(value: T, transformer: (value: T) => R): T extends Promise<any> ? Promise<R> : R;
+export declare const MaybePromise: {
+    transform: typeof transformMaybePromise;
+};
+//# sourceMappingURL=MaybePromise.d.ts.map

package/cjs/promise/MaybePromise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaybePromise.d.ts","sourceRoot":"","sources":["../../ts/promise/MaybePromise.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAE5C;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AACxG;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAK5H,eAAO,MAAM,YAAY;;CAExB,CAAA"}

package/cjs/promise/MaybePromise.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MaybePromise = exports.transformMaybePromise = void 0;
+var isPromise_js_1 = require("./isPromise.js");
+function transformMaybePromise(value, transformer) {
+    return (0, isPromise_js_1.isPromise)(value) ? value.then(transformer) : transformer(value);
+}
+exports.transformMaybePromise = transformMaybePromise;
+exports.MaybePromise = {
+    transform: transformMaybePromise
+};
+//# sourceMappingURL=MaybePromise.js.map

package/cjs/promise/MaybePromise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaybePromise.js","sourceRoot":"","sources":["../../ts/promise/MaybePromise.ts"],"names":[],"mappings":";;;AAAA,+CAA0C;AAqB1C,SAAgB,qBAAqB,CAAO,KAAsB,EAAE,WAA4B;IAC9F,OAAO,IAAA,wBAAS,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;AACxE,CAAC;AAFD,sDAEC;AAEY,QAAA,YAAY,GAAG;IAC1B,SAAS,EAAE,qBAAqB;CACjC,CAAA"}

package/cjs/promise/MaybePromise.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=MaybePromise.spec.d.ts.map

package/cjs/promise/MaybePromise.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaybePromise.spec.d.ts","sourceRoot":"","sources":["../../ts/promise/MaybePromise.spec.ts"],"names":[],"mappings":""}

package/cjs/promise/MaybePromise.spec.js

@@ -0,0 +1,69 @@
+"use strict";
+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 };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var index_js_1 = require("../index.js");
+describe("".concat(index_js_1.MaybePromise.transform.name, "()"), function () {
+    it('returns the result from the handler directly if it is not a promise', function () {
+        var r = index_js_1.MaybePromise.transform(1, function (v) { return String(v); });
+        index_js_1.isType.equal();
+        expect(r).toEqual('1');
+    });
+    it('returns a promise that resolves to the result from the handler', function () { return __awaiter(void 0, void 0, void 0, function () {
+        var r, _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    r = index_js_1.MaybePromise.transform(Promise.resolve(1), function (v) { return String(v); });
+                    index_js_1.isType.equal();
+                    expect(r).not.toEqual('1');
+                    _a = expect;
+                    return [4 /*yield*/, r];
+                case 1:
+                    _a.apply(void 0, [_b.sent()]).toEqual('1');
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    it('preserves the type of it is MaybePromise', function () {
+        var v = 1;
+        var r = index_js_1.MaybePromise.transform(v, function (v) { return String(v); });
+        index_js_1.isType.equal();
+        expect(r).toEqual('1');
+    });
+});
+//# sourceMappingURL=MaybePromise.spec.js.map

package/cjs/promise/MaybePromise.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaybePromise.spec.js","sourceRoot":"","sources":["../../ts/promise/MaybePromise.spec.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wCAAkD;AAElD,QAAQ,CAAC,UAAG,uBAAY,CAAC,SAAS,CAAC,IAAI,OAAI,EAAE;IAC3C,EAAE,CAAC,qEAAqE,EAAE;QACxE,IAAM,CAAC,GAAG,uBAAY,CAAC,SAAS,CAAC,CAAC,EAAE,UAAA,CAAC,IAAI,OAAA,MAAM,CAAC,CAAC,CAAC,EAAT,CAAS,CAAC,CAAA;QAEnD,iBAAM,CAAC,KAAK,EAA0B,CAAA;QACtC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gEAAgE,EAAE;;;;;oBAC7D,CAAC,GAAG,uBAAY,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAA,CAAC,IAAI,OAAA,MAAM,CAAC,CAAC,CAAC,EAAT,CAAS,CAAC,CAAA;oBAEpE,iBAAM,CAAC,KAAK,EAAmC,CAAA;oBAC/C,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;oBAC1B,KAAA,MAAM,CAAA;oBAAC,qBAAM,CAAC,EAAA;;oBAAd,kBAAO,SAAO,EAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;;;;SAC7B,CAAC,CAAA;IAEF,EAAE,CAAC,0CAA0C,EAAE;QAC7C,IAAM,CAAC,GAAyB,CAAyB,CAAA;QACzD,IAAM,CAAC,GAAG,uBAAY,CAAC,SAAS,CAAC,CAAC,EAAE,UAAA,CAAC,IAAI,OAAA,MAAM,CAAC,CAAC,CAAC,EAAT,CAAS,CAAC,CAAA;QACnD,iBAAM,CAAC,KAAK,EAA4C,CAAA;QACxD,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/cjs/promise/index.d.ts

@@ -1,5 +1,6 @@
 export * from './isPromise.js';
+export * from './mapSeries.js';
+export * from './MaybePromise.js';
 export type { PromiseValue } from './PromiseValue.js';
 export type { PromiseValueMerge } from './PromiseValueMerge.js';
-export * from './mapSeries.js';
 //# sourceMappingURL=index.d.ts.map

package/cjs/promise/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../ts/promise/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../ts/promise/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA"}

package/cjs/promise/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./isPromise.js"), exports);
 __exportStar(require("./mapSeries.js"), exports);
+__exportStar(require("./MaybePromise.js"), exports);
 //# sourceMappingURL=index.js.map

package/cjs/promise/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/promise/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA8B;AAG9B,iDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/promise/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA8B;AAC9B,iDAA8B;AAC9B,oDAAiC"}

package/esm/promise/MaybePromise.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `T | Promise<T>`
+ */
+export declare type MaybePromise<T> = T | Promise<T>;
+/**
+ * Transforms the value within the promise.
+ *
+ * @return a new promise with the transformed result.
+ */
+export declare function transformMaybePromise<T, R>(value: Promise<T>, transformer: (value: T) => R): Promise<R>;
+/**
+ * Transforms the value, or if the value is a promise,
+ * transform the resolved value of the promise.
+ *
+ * @return the transformed result,
+ * or if the value is a promise, a new promse with the transformed result.
+ */
+export declare function transformMaybePromise<T, R>(value: T, transformer: (value: T) => R): T extends Promise<any> ? Promise<R> : R;
+export declare const MaybePromise: {
+    transform: typeof transformMaybePromise;
+};
+//# sourceMappingURL=MaybePromise.d.ts.map

package/esm/promise/MaybePromise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaybePromise.d.ts","sourceRoot":"","sources":["../../ts/promise/MaybePromise.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAE5C;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AACxG;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAK5H,eAAO,MAAM,YAAY;;CAExB,CAAA"}

package/esm/promise/MaybePromise.js

@@ -0,0 +1,8 @@
+import { isPromise } from './isPromise.js';
+export function transformMaybePromise(value, transformer) {
+    return isPromise(value) ? value.then(transformer) : transformer(value);
+}
+export const MaybePromise = {
+    transform: transformMaybePromise
+};
+//# sourceMappingURL=MaybePromise.js.map

package/esm/promise/MaybePromise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaybePromise.js","sourceRoot":"","sources":["../../ts/promise/MaybePromise.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAqB1C,MAAM,UAAU,qBAAqB,CAAO,KAAsB,EAAE,WAA4B;IAC9F,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;AACxE,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS,EAAE,qBAAqB;CACjC,CAAA"}

package/esm/promise/MaybePromise.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=MaybePromise.spec.d.ts.map

package/esm/promise/MaybePromise.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaybePromise.spec.d.ts","sourceRoot":"","sources":["../../ts/promise/MaybePromise.spec.ts"],"names":[],"mappings":""}

package/esm/promise/MaybePromise.spec.js

@@ -0,0 +1,21 @@
+import { isType, MaybePromise } from '../index.js';
+describe(`${MaybePromise.transform.name}()`, () => {
+    it('returns the result from the handler directly if it is not a promise', () => {
+        const r = MaybePromise.transform(1, v => String(v));
+        isType.equal();
+        expect(r).toEqual('1');
+    });
+    it('returns a promise that resolves to the result from the handler', async () => {
+        const r = MaybePromise.transform(Promise.resolve(1), v => String(v));
+        isType.equal();
+        expect(r).not.toEqual('1');
+        expect(await r).toEqual('1');
+    });
+    it('preserves the type of it is MaybePromise', () => {
+        const v = 1;
+        const r = MaybePromise.transform(v, v => String(v));
+        isType.equal();
+        expect(r).toEqual('1');
+    });
+});
+//# sourceMappingURL=MaybePromise.spec.js.map

package/esm/promise/MaybePromise.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaybePromise.spec.js","sourceRoot":"","sources":["../../ts/promise/MaybePromise.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAElD,QAAQ,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,GAAG,EAAE;IAChD,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QAEnD,MAAM,CAAC,KAAK,EAA0B,CAAA;QACtC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QAEpE,MAAM,CAAC,KAAK,EAAmC,CAAA;QAC/C,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAC1B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAyB,CAAyB,CAAA;QACzD,MAAM,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QACnD,MAAM,CAAC,KAAK,EAA4C,CAAA;QACxD,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/esm/promise/index.d.ts

@@ -1,5 +1,6 @@
 export * from './isPromise.js';
+export * from './mapSeries.js';
+export * from './MaybePromise.js';
 export type { PromiseValue } from './PromiseValue.js';
 export type { PromiseValueMerge } from './PromiseValueMerge.js';
-export * from './mapSeries.js';
 //# sourceMappingURL=index.d.ts.map

package/esm/promise/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../ts/promise/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../ts/promise/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA"}

package/esm/promise/index.js

@@ -1,3 +1,4 @@
 export * from './isPromise.js';
 export * from './mapSeries.js';
+export * from './MaybePromise.js';
 //# sourceMappingURL=index.js.map

package/esm/promise/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/promise/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAG9B,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ts/promise/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "type-plus",
-  "version": "4.15.2",
+  "version": "4.16.0",
   "description": "Provides additional types for TypeScript.",
   "homepage": "https://github.com/unional/type-plus",
   "bugs": {

package/ts/promise/MaybePromise.ts

@@ -0,0 +1,28 @@
+import { isPromise } from './isPromise.js'
+
+/**
+ * `T | Promise<T>`
+ */
+export type MaybePromise<T> = T | Promise<T>
+
+/**
+ * Transforms the value within the promise.
+ *
+ * @return a new promise with the transformed result.
+ */
+export function transformMaybePromise<T, R>(value: Promise<T>, transformer: (value: T) => R): Promise<R>
+/**
+ * Transforms the value, or if the value is a promise,
+ * transform the resolved value of the promise.
+ *
+ * @return the transformed result,
+ * or if the value is a promise, a new promse with the transformed result.
+ */
+export function transformMaybePromise<T, R>(value: T, transformer: (value: T) => R): T extends Promise<any> ? Promise<R> : R
+export function transformMaybePromise<T, R>(value: MaybePromise<T>, transformer: (value: T) => R) {
+  return isPromise(value) ? value.then(transformer) : transformer(value)
+}
+
+export const MaybePromise = {
+  transform: transformMaybePromise
+}

package/ts/promise/index.ts

@@ -1,4 +1,5 @@
 export * from './isPromise.js'
+export * from './mapSeries.js'
+export * from './MaybePromise.js'
 export type { PromiseValue } from './PromiseValue.js'
 export type { PromiseValueMerge } from './PromiseValueMerge.js'
-export * from './mapSeries.js'