type-fns 1.13.0 → 1.15.0

package/dist/checks/isKeyOf.d.ts

@@ -0,0 +1 @@
+export declare const isKeyOf: <T extends Record<string, any>>(obj: T, key: PropertyKey) => key is keyof T;

package/dist/checks/isKeyOf.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isKeyOf = void 0;
+const isKeyOf = (obj, key) => {
+    return key in obj;
+};
+exports.isKeyOf = isKeyOf;
+//# sourceMappingURL=isKeyOf.js.map

package/dist/checks/isKeyOf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isKeyOf.js","sourceRoot":"","sources":["../../src/checks/isKeyOf.ts"],"names":[],"mappings":";;;AAAO,MAAM,OAAO,GAAG,CACrB,GAAM,EACN,GAAgB,EACA,EAAE;IAClB,OAAO,GAAG,IAAI,GAAG,CAAC;AACpB,CAAC,CAAC;AALW,QAAA,OAAO,WAKlB"}

package/dist/index.d.ts

@@ -14,3 +14,5 @@ export * from './companions/omit';
 export * from './companions/pick';
 export * from './types/Literalize';
 export * from './wrappers/withAssure';
+export * from './checks/isKeyOf';
+export * from './types/PickAny';

package/dist/index.js

@@ -30,4 +30,6 @@ __exportStar(require("./companions/omit"), exports);
 __exportStar(require("./companions/pick"), exports);
 __exportStar(require("./types/Literalize"), exports);
 __exportStar(require("./wrappers/withAssure"), exports);
+__exportStar(require("./checks/isKeyOf"), exports);
+__exportStar(require("./types/PickAny"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,mDAAiC;AACjC,uDAAqC;AACrC,qDAAmC;AACnC,oDAAkC;AAClC,qDAAmC;AACnC,uDAAqC;AACrC,sDAAoC;AACpC,kDAAgC;AAChC,qDAAmC;AACnC,0DAAwC;AACxC,oDAAkC;AAClC,oDAAkC;AAClC,oDAAkC;AAClC,qDAAmC;AACnC,wDAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,mDAAiC;AACjC,uDAAqC;AACrC,qDAAmC;AACnC,oDAAkC;AAClC,qDAAmC;AACnC,uDAAqC;AACrC,sDAAoC;AACpC,kDAAgC;AAChC,qDAAmC;AACnC,0DAAwC;AACxC,oDAAkC;AAClC,oDAAkC;AAClC,oDAAkC;AAClC,qDAAmC;AACnC,wDAAsC;AACtC,mDAAiC;AACjC,kDAAgC"}

package/dist/types/PickAny.d.ts

@@ -0,0 +1,9 @@
+/**
+ * creates a type which requires specifying at least one, or more, key of an object
+ *
+ * ref:
+ * - https://stackoverflow.com/a/49725198/3068233
+ */
+export type PickAny<TObj, TKeys extends keyof TObj = keyof TObj> = Pick<TObj, Exclude<keyof TObj, TKeys>> & {
+    [K in TKeys]-?: Required<Pick<TObj, K>> & Partial<Pick<TObj, Exclude<TKeys, K>>>;
+}[TKeys];

package/dist/types/PickAny.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=PickAny.js.map

package/dist/types/PickAny.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PickAny.js","sourceRoot":"","sources":["../../src/types/PickAny.ts"],"names":[],"mappings":""}

package/dist/types/PickAny.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/PickAny.test.js

@@ -0,0 +1,45 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+describe('PickAny', () => {
+    it('should constrain type correctly', () => __awaiter(void 0, void 0, void 0, function* () {
+        const findFlowers = (input) => __awaiter(void 0, void 0, void 0, function* () {
+            // ...
+        });
+        // you can find by color
+        yield findFlowers({
+            color: {
+                petals: 'white',
+            },
+        });
+        // you can find by size
+        yield findFlowers({
+            size: {
+                choice: 'LARGE',
+            },
+        });
+        // you can find by both
+        yield findFlowers({
+            color: {
+                petals: 'white',
+            },
+            size: {
+                choice: 'LARGE',
+            },
+        });
+        // you can't find by neither
+        yield findFlowers({
+            // @ts-expect-error - cant be neither
+            size: {},
+        });
+    }));
+});
+//# sourceMappingURL=PickAny.test.js.map

package/dist/types/PickAny.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PickAny.test.js","sourceRoot":"","sources":["../../src/types/PickAny.test.ts"],"names":[],"mappings":";;;;;;;;;;;AAEA,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,iCAAiC,EAAE,GAAS,EAAE;QAC/C,MAAM,WAAW,GAAG,CAClB,KAOE,EACF,EAAE;YACF,MAAM;QACR,CAAC,CAAA,CAAC;QAEF,wBAAwB;QACxB,MAAM,WAAW,CAAC;YAChB,KAAK,EAAE;gBACL,MAAM,EAAE,OAAO;aAChB;SACF,CAAC,CAAC;QAEH,uBAAuB;QACvB,MAAM,WAAW,CAAC;YAChB,IAAI,EAAE;gBACJ,MAAM,EAAE,OAAO;aAChB;SACF,CAAC,CAAC;QAEH,uBAAuB;QACvB,MAAM,WAAW,CAAC;YAChB,KAAK,EAAE;gBACL,MAAM,EAAE,OAAO;aAChB;YACD,IAAI,EAAE;gBACJ,MAAM,EAAE,OAAO;aAChB;SACF,CAAC,CAAC;QAEH,4BAA4B;QAC5B,MAAM,WAAW,CAAC;YAChB,qCAAqC;YACrC,IAAI,EAAE,EAAE;SACT,CAAC,CAAC;IACL,CAAC,CAAA,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types/PickOne.test.js

@@ -27,12 +27,18 @@ describe('PickOne', () => {
             },
         });
         // you can't find by both
-        // await findWrench({
-        //   size: {
-        //     metric: { millimeters: 16 },
-        //     imperial: { inches: '5/16' },
-        //   },
-        // });
+        yield findWrench({
+            // @ts-expect-error - cant be both
+            size: {
+                metric: { millimeters: 16 },
+                imperial: { inches: '5/16' },
+            },
+        });
+        // you can't find by neither
+        yield findWrench({
+            // @ts-expect-error - cant be neither
+            size: {},
+        });
     }));
 });
 //# sourceMappingURL=PickOne.test.js.map

package/dist/types/PickOne.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"PickOne.test.js","sourceRoot":"","sources":["../../src/types/PickOne.test.ts"],"names":[],"mappings":";;;;;;;;;;;AAEA,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,iCAAiC,EAAE,GAAS,EAAE;QAC/C,MAAM,UAAU,GAAG,KAehB,EAAE,4CAfqB,EAezB;YACC,MAAM;QACR,CAAC,CAAA,CAAC;QAEF,yBAAyB;QACzB,MAAM,UAAU,CAAC;YACf,IAAI,EAAE;gBACJ,MAAM,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;aAC5B;SACF,CAAC,CAAC;QAEH,2BAA2B;QAC3B,MAAM,UAAU,CAAC;YACf,IAAI,EAAE;gBACJ,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;aAC7B;SACF,CAAC,CAAC;QAEH,yBAAyB;QACzB,qBAAqB;QACrB,YAAY;QACZ,mCAAmC;QACnC,oCAAoC;QACpC,OAAO;QACP,MAAM;IACR,CAAC,CAAA,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"PickOne.test.js","sourceRoot":"","sources":["../../src/types/PickOne.test.ts"],"names":[],"mappings":";;;;;;;;;;;AAEA,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,iCAAiC,EAAE,GAAS,EAAE;QAC/C,MAAM,UAAU,GAAG,KAehB,EAAE,4CAfqB,EAezB;YACC,MAAM;QACR,CAAC,CAAA,CAAC;QAEF,yBAAyB;QACzB,MAAM,UAAU,CAAC;YACf,IAAI,EAAE;gBACJ,MAAM,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;aAC5B;SACF,CAAC,CAAC;QAEH,2BAA2B;QAC3B,MAAM,UAAU,CAAC;YACf,IAAI,EAAE;gBACJ,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;aAC7B;SACF,CAAC,CAAC;QAEH,yBAAyB;QACzB,MAAM,UAAU,CAAC;YACf,kCAAkC;YAClC,IAAI,EAAE;gBACJ,MAAM,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;gBAC3B,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;aAC7B;SACF,CAAC,CAAC;QAEH,4BAA4B;QAC5B,MAAM,UAAU,CAAC;YACf,qCAAqC;YACrC,IAAI,EAAE,EAAE;SACT,CAAC,CAAC;IACL,CAAC,CAAA,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "type-fns",
   "author": "ehmpathy",
   "description": "A set of types, type checks, and type guards for simpler, safer, and easier to read code.",
-  "version": "1.13.0",
+  "version": "1.15.0",
   "repository": "ehmpathy/type-fns",
   "homepage": "https://github.com/ehmpathy/type-fns",
   "keywords": [