@naturalcycles/js-lib 15.55.1 → 15.56.0

package/dist/object/object.util.d.ts

@@ -1,4 +1,4 @@
-import type { AnyObject, KeyValueTuple, MutateOptions, ObjectMapper, ObjectPredicate, Reviver, StringMap, ValueOf } from '../types.js';
+import type { AnyObject, KeyValueTuple, MutateOptions, ObjectMapper, ObjectPredicate, RequiredProp, Reviver, StringMap, ValueOf } from '../types.js';
 import { SKIP } from '../types.js';
 /**
  * Returns clone of `obj` with only `props` preserved.
@@ -228,4 +228,13 @@ export declare function _deepFreeze(o: any): void;
  * To make mutation extra clear - function returns void (unlike Object.assign).
  */
 export declare function _objectAssignExact<T extends AnyObject>(target: T, source: T): void;
+/**
+ * type MyObj = { a?: string, b?: string }
+ *
+ * const collection: MyObj[] = [...]
+ *
+ * const collectionA = collection.filter(_hasProp('a'))
+ * --> collectionA is now RequiredProp<MyObj, 'a'>[], i.e. { a: string, b?: string }[]
+ */
+export declare function _hasProp<T, Prop extends keyof T>(prop: Prop): (object: T) => object is RequiredProp<T, Prop>;
 export {};

package/dist/object/object.util.js

@@ -446,3 +446,16 @@ export function _objectAssignExact(target, source) {
         }
     }
 }
+/**
+ * type MyObj = { a?: string, b?: string }
+ *
+ * const collection: MyObj[] = [...]
+ *
+ * const collectionA = collection.filter(_hasProp('a'))
+ * --> collectionA is now RequiredProp<MyObj, 'a'>[], i.e. { a: string, b?: string }[]
+ */
+export function _hasProp(prop) {
+    return function (object) {
+        return typeof object[prop] !== 'undefined';
+    };
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.55.1",
+  "version": "15.56.0",
   "dependencies": {
     "tslib": "^2",
     "undici": "^7",

package/src/object/object.util.ts

@@ -5,6 +5,7 @@ import type {
   MutateOptions,
   ObjectMapper,
   ObjectPredicate,
+  RequiredProp,
   Reviver,
   StringMap,
   ValueOf,
@@ -527,3 +528,17 @@ export function _objectAssignExact<T extends AnyObject>(target: T, source: T): v
     }
   }
 }
+
+/**
+ * type MyObj = { a?: string, b?: string }
+ *
+ * const collection: MyObj[] = [...]
+ *
+ * const collectionA = collection.filter(_hasProp('a'))
+ * --> collectionA is now RequiredProp<MyObj, 'a'>[], i.e. { a: string, b?: string }[]
+ */
+export function _hasProp<T, Prop extends keyof T>(prop: Prop) {
+  return function (object: T): object is RequiredProp<T, Prop> {
+    return typeof object[prop] !== 'undefined'
+  }
+}