type-plus 4.15.1 → 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/nominal-types/Brand.d.ts

@@ -4,11 +4,11 @@ import { typeSym, valueSym } from './types.js';
  * Create a "branded" version of a type.
  * TypeScript won't allow implicit conversion to this type
  */
-export declare type Brand<B extends string, T> = T extends undefined | null | number | bigint | boolean ? {
+export declare type Brand<B extends string, T> = T extends object ? T & {
     [typeSym]: B;
-    [valueSym]: T;
-} : T & {
+} : {
     [typeSym]: B;
+    [valueSym]: T;
 };
 /**
  * Creates a brand creator with the specified type.

package/cjs/nominal-types/Brand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Brand.d.ts","sourceRoot":"","sources":["../../ts/nominal-types/Brand.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE9C;;;GAGG;AACH,oBAAY,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,IACnC,CAAC,SAAS,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GACpD;IAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;CAAE,GAC/B,CAAC,GAAG;IAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AAExB;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AACvF;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA"}
+{"version":3,"file":"Brand.d.ts","sourceRoot":"","sources":["../../ts/nominal-types/Brand.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE9C;;;GAGG;AACH,oBAAY,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,IACnC,CAAC,SAAS,MAAM,GACd,CAAC,GAAG;IAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE,GACpB;IAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AAEnC;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AACvF;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/cjs/nominal-types/Brand.spec.js

@@ -3,30 +3,45 @@ Object.defineProperty(exports, "__esModule", { value: true });
 var index_js_1 = require("../index.js");
 var index_js_2 = require("../predicates/index.js");
 describe('brand()', function () {
-    test('unbranded type cannot assign to branded type', function () {
+    it('cannot assign from unbranded type', function () {
         var a = (0, index_js_1.brand)('a', { a: 1 });
         var b = { a: 1 };
         index_js_2.isType.f();
     });
-    test('basic use case', function () {
+    it('can assign to unbranded type', function () {
+        var a = { a: 1 };
+        var b = (0, index_js_1.brand)('a', { a: 1 });
+        index_js_2.isType.t();
+    });
+    it('cannot assign between two different brand', function () {
         var a = (0, index_js_1.brand)('a', { a: 1 });
         var b = (0, index_js_1.brand)('b', { b: 'b' });
         index_js_2.isType.f();
         (0, index_js_1.assertType)(a.a);
         (0, index_js_1.assertType)(b.b);
     });
-    test('same brand of the same type can be assigned to each other', function () {
+    it('can assign betwen same brand of the same type', function () {
         var a = (0, index_js_1.brand)('a', { a: 1 });
         var b = (0, index_js_1.brand)('a', { a: 2 });
         b = a;
         expect(b.a).toBe(1);
     });
-    test('flavor with the same name cannot be assigned to brand', function () {
+    it('cannot assign betwen same brand with different type', function () {
+        var a = (0, index_js_1.brand)('a', { a: 1 });
+        var b = (0, index_js_1.brand)('a', { b: 2 });
+        index_js_2.isType.f();
+    });
+    it('cannot assign from flavor with the same name', function () {
         var b = (0, index_js_1.brand)('x', { a: 1 });
         var f = (0, index_js_1.flavor)('x', { a: 1 });
         index_js_2.isType.f();
     });
-    test('without subject creates a typed brand creator', function () {
+    it('can assign to flavor with the same name (this is a feature of flavor)', function () {
+        var b = (0, index_js_1.brand)('x', { a: 1 });
+        var f = (0, index_js_1.flavor)('x', { a: 1 });
+        index_js_2.isType.t();
+    });
+    it('creates a typed brand ceator when invoke without subject', function () {
         var createPerson = (0, index_js_1.brand)('person');
         var person1 = createPerson(1);
         var person2 = createPerson(2);
@@ -36,5 +51,36 @@ describe('brand()', function () {
         person2 = person1;
         index_js_2.isType.f();
     });
+    it('accepts null as subject', function () {
+        var b = (0, index_js_1.brand)('x', null);
+        index_js_2.isType.equal();
+    });
+    it('accepts undefined as subject', function () {
+        var b = (0, index_js_1.brand)('x', undefined);
+        index_js_2.isType.equal();
+    });
+    it('accepts function as subject', function () {
+        var b = (0, index_js_1.brand)('x', function boo() { });
+        var c = (0, index_js_1.brand)('x', function coo() { });
+        index_js_2.isType.equal();
+        index_js_2.isType.t();
+        index_js_2.isType.t();
+    });
+    it('can assign to another function brand based on function assignment logic', function () {
+        function af() { }
+        function bf(_) { }
+        function cf(_) { }
+        var a = (0, index_js_1.brand)('x', af);
+        var b = (0, index_js_1.brand)('x', bf);
+        var c = (0, index_js_1.brand)('x', cf);
+        index_js_2.isType.t();
+        index_js_2.isType.t();
+        index_js_2.isType.f();
+        index_js_2.isType.f();
+        index_js_2.isType.f();
+        index_js_2.isType.f();
+        index_js_2.isType.f();
+        index_js_2.isType.f();
+    });
 });
 //# sourceMappingURL=Brand.spec.js.map

package/cjs/nominal-types/Brand.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"Brand.spec.js","sourceRoot":"","sources":["../../ts/nominal-types/Brand.spec.ts"],"names":[],"mappings":";;AAAA,wCAAyE;AACzE,mDAA+C;AAE/C,QAAQ,CAAC,SAAS,EAAE;IAClB,IAAI,CAAC,8CAA8C,EAAE;QACnD,IAAM,CAAC,GAAG,IAAA,gBAAK,EAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAC9B,IAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;QAClB,iBAAM,CAAC,CAAC,EAAiC,CAAA;IAC3C,CAAC,CAAC,CAAA;IACF,IAAI,CAAC,gBAAgB,EAAE;QACrB,IAAM,CAAC,GAAG,IAAA,gBAAK,EAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAU,EAAE,CAAC,CAAA;QACvC,IAAM,CAAC,GAAG,IAAA,gBAAK,EAAC,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;QAEhC,iBAAM,CAAC,CAAC,EAAiC,CAAA;QACzC,IAAA,qBAAU,EAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QAClB,IAAA,qBAAU,EAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;IACF,IAAI,CAAC,2DAA2D,EAAE;QAChE,IAAM,CAAC,GAAG,IAAA,gBAAK,EAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAC9B,IAAI,CAAC,GAAG,IAAA,gBAAK,EAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAE5B,CAAC,GAAG,CAAC,CAAA;QACL,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACrB,CAAC,CAAC,CAAA;IACF,IAAI,CAAC,uDAAuD,EAAE;QAC5D,IAAM,CAAC,GAAG,IAAA,gBAAK,EAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAC9B,IAAM,CAAC,GAAG,IAAA,iBAAM,EAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAC/B,iBAAM,CAAC,CAAC,EAAiC,CAAA;IAC3C,CAAC,CAAC,CAAA;IACF,IAAI,CAAC,+CAA+C,EAAE;QACpD,IAAM,YAAY,GAAG,IAAA,gBAAK,EAAC,QAAQ,CAAC,CAAA;QACpC,IAAI,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;QAC7B,IAAI,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;QAE7B,IAAM,cAAc,GAAG,IAAA,gBAAK,EAAC,MAAM,CAAC,CAAA;QACpC,IAAM,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC,CAAA;QAElC,OAAO,GAAG,OAAO,CAAA;QACjB,OAAO,GAAG,OAAO,CAAA;QAEjB,iBAAM,CAAC,CAAC,EAA0C,CAAA;IACpD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"Brand.spec.js","sourceRoot":"","sources":["../../ts/nominal-types/Brand.spec.ts"],"names":[],"mappings":"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"}

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/nominal-types/Brand.d.ts

@@ -4,11 +4,11 @@ import { typeSym, valueSym } from './types.js';
  * Create a "branded" version of a type.
  * TypeScript won't allow implicit conversion to this type
  */
-export declare type Brand<B extends string, T> = T extends undefined | null | number | bigint | boolean ? {
+export declare type Brand<B extends string, T> = T extends object ? T & {
     [typeSym]: B;
-    [valueSym]: T;
-} : T & {
+} : {
     [typeSym]: B;
+    [valueSym]: T;
 };
 /**
  * Creates a brand creator with the specified type.

package/esm/nominal-types/Brand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Brand.d.ts","sourceRoot":"","sources":["../../ts/nominal-types/Brand.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE9C;;;GAGG;AACH,oBAAY,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,IACnC,CAAC,SAAS,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GACpD;IAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;CAAE,GAC/B,CAAC,GAAG;IAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AAExB;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AACvF;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA"}
+{"version":3,"file":"Brand.d.ts","sourceRoot":"","sources":["../../ts/nominal-types/Brand.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE9C;;;GAGG;AACH,oBAAY,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,IACnC,CAAC,SAAS,MAAM,GACd,CAAC,GAAG;IAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE,GACpB;IAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AAEnC;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AACvF;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/esm/nominal-types/Brand.spec.js

@@ -1,30 +1,45 @@
 import { assertType, brand, flavor } from '../index.js';
 import { isType } from '../predicates/index.js';
 describe('brand()', () => {
-    test('unbranded type cannot assign to branded type', () => {
+    it('cannot assign from unbranded type', () => {
         const a = brand('a', { a: 1 });
         const b = { a: 1 };
         isType.f();
     });
-    test('basic use case', () => {
+    it('can assign to unbranded type', () => {
+        const a = { a: 1 };
+        const b = brand('a', { a: 1 });
+        isType.t();
+    });
+    it('cannot assign between two different brand', () => {
         const a = brand('a', { a: 1 });
         const b = brand('b', { b: 'b' });
         isType.f();
         assertType(a.a);
         assertType(b.b);
     });
-    test('same brand of the same type can be assigned to each other', () => {
+    it('can assign betwen same brand of the same type', () => {
         const a = brand('a', { a: 1 });
         let b = brand('a', { a: 2 });
         b = a;
         expect(b.a).toBe(1);
     });
-    test('flavor with the same name cannot be assigned to brand', () => {
+    it('cannot assign betwen same brand with different type', () => {
+        const a = brand('a', { a: 1 });
+        const b = brand('a', { b: 2 });
+        isType.f();
+    });
+    it('cannot assign from flavor with the same name', () => {
         const b = brand('x', { a: 1 });
         const f = flavor('x', { a: 1 });
         isType.f();
     });
-    test('without subject creates a typed brand creator', () => {
+    it('can assign to flavor with the same name (this is a feature of flavor)', () => {
+        const b = brand('x', { a: 1 });
+        const f = flavor('x', { a: 1 });
+        isType.t();
+    });
+    it('creates a typed brand ceator when invoke without subject', () => {
         const createPerson = brand('person');
         let person1 = createPerson(1);
         let person2 = createPerson(2);
@@ -34,5 +49,36 @@ describe('brand()', () => {
         person2 = person1;
         isType.f();
     });
+    it('accepts null as subject', () => {
+        const b = brand('x', null);
+        isType.equal();
+    });
+    it('accepts undefined as subject', () => {
+        const b = brand('x', undefined);
+        isType.equal();
+    });
+    it('accepts function as subject', () => {
+        const b = brand('x', function boo() { });
+        const c = brand('x', function coo() { });
+        isType.equal();
+        isType.t();
+        isType.t();
+    });
+    it('can assign to another function brand based on function assignment logic', () => {
+        function af() { }
+        function bf(_) { }
+        function cf(_) { }
+        const a = brand('x', af);
+        const b = brand('x', bf);
+        const c = brand('x', cf);
+        isType.t();
+        isType.t();
+        isType.f();
+        isType.f();
+        isType.f();
+        isType.f();
+        isType.f();
+        isType.f();
+    });
 });
 //# sourceMappingURL=Brand.spec.js.map

package/esm/nominal-types/Brand.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"Brand.spec.js","sourceRoot":"","sources":["../../ts/nominal-types/Brand.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAoB,MAAM,EAAE,MAAM,aAAa,CAAA;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAE/C,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,IAAI,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAC9B,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAA;QAClB,MAAM,CAAC,CAAC,EAAiC,CAAA;IAC3C,CAAC,CAAC,CAAA;IACF,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAU,EAAE,CAAC,CAAA;QACvC,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;QAEhC,MAAM,CAAC,CAAC,EAAiC,CAAA;QACzC,UAAU,CAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QAClB,UAAU,CAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;IACF,IAAI,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAC9B,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAE5B,CAAC,GAAG,CAAC,CAAA;QACL,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACrB,CAAC,CAAC,CAAA;IACF,IAAI,CAAC,uDAAuD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAC/B,MAAM,CAAC,CAAC,EAAiC,CAAA;IAC3C,CAAC,CAAC,CAAA;IACF,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACzD,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAA;QACpC,IAAI,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;QAC7B,IAAI,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAA;QAE7B,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;QACpC,MAAM,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC,CAAA;QAElC,OAAO,GAAG,OAAO,CAAA;QACjB,OAAO,GAAG,OAAO,CAAA;QAEjB,MAAM,CAAC,CAAC,EAA0C,CAAA;IACpD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"Brand.spec.js","sourceRoot":"","sources":["../../ts/nominal-types/Brand.spec.ts"],"names":[],"mappings":"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"}

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.1",
+  "version": "4.16.0",
   "description": "Provides additional types for TypeScript.",
   "homepage": "https://github.com/unional/type-plus",
   "bugs": {

package/ts/nominal-types/Brand.ts

@@ -1,32 +1,32 @@
-// By Drew Colthorp, <https://spin.atomicobject.com/2018/01/15/typescript-flexible-nominal-typing/#comment-604580>
-// <https://gist.github.com/dcolthorp/aa21cf87d847ae9942106435bf47565d>
-
-import { Widen } from '../utils/index.js'
-import { typeSym, valueSym } from './types.js'
-
-/**
- * Create a "branded" version of a type.
- * TypeScript won't allow implicit conversion to this type
- */
-export type Brand<B extends string, T> =
-  T extends undefined | null | number | bigint | boolean
-  ? { [typeSym]: B, [valueSym]: T }
-  : T & { [typeSym]: B }
-
-/**
- * Creates a brand creator with the specified type.
- */
-export function brand<B extends string>(type: B): <T>(subject: T) => Brand<B, Widen<T>>
-/**
- * Creates a branded value of specified type.
- */
-export function brand<B extends string, T>(type: B, subject: T): Brand<B, Widen<T>>
-export function brand(type: string, subject?: unknown) {
-  if (subject === undefined) return function <T>(subject: T) { return brand(type, subject) }
-
-  if (typeof subject === 'object' && subject !== null) {
-    // if subject is not an object, the branding will exist only in type-level.
-    (subject as { [typeSym]: string })[typeSym] = type
-  }
-  return subject
-}
+// By Drew Colthorp, <https://spin.atomicobject.com/2018/01/15/typescript-flexible-nominal-typing/#comment-604580>
+// <https://gist.github.com/dcolthorp/aa21cf87d847ae9942106435bf47565d>
+
+import { Widen } from '../utils/index.js'
+import { typeSym, valueSym } from './types.js'
+
+/**
+ * Create a "branded" version of a type.
+ * TypeScript won't allow implicit conversion to this type
+ */
+export type Brand<B extends string, T> =
+  T extends object
+  ? T & { [typeSym]: B }
+  : { [typeSym]: B, [valueSym]: T }
+
+/**
+ * Creates a brand creator with the specified type.
+ */
+export function brand<B extends string>(type: B): <T>(subject: T) => Brand<B, Widen<T>>
+/**
+ * Creates a branded value of specified type.
+ */
+export function brand<B extends string, T>(type: B, subject: T): Brand<B, Widen<T>>
+export function brand(type: string, subject?: unknown) {
+  if (subject === undefined) return function <T>(subject: T) { return brand(type, subject) }
+
+  if (typeof subject === 'object' && subject !== null) {
+    // if subject is not an object, the branding will exist only in type-level.
+    (subject as { [typeSym]: string })[typeSym] = type
+  }
+  return subject
+}

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'