@web-ts-toolkit/utils 0.29.0 → 0.30.0

package/README.md

@@ -10,8 +10,8 @@ pnpm add @web-ts-toolkit/utils
 
 ## Highlights
 
-- object-path helpers such as `get(...)` and `set(...)`
-- collection helpers such as `map(...)`, `filter(...)`, `uniq(...)`, and `orderBy(...)`
+- object-path helpers such as `get(...)`, `set(...)`, and `hasOwn(...)`
+- collection helpers such as `map(...)`, `filter(...)`, `uniq(...)`, `uniqBy(...)`, and `orderBy(...)`
 - small type guards
 - URL helpers such as `normalizeUrlPath(...)`
 - async helpers such as `mapValuesAsync(...)`
@@ -19,7 +19,16 @@ pnpm add @web-ts-toolkit/utils
 ## Quick Start
 
 ```ts
-import { get, groupBy, normalizeUrlPath, parseBooleanString, startCase, sumBy } from '@web-ts-toolkit/utils';
+import {
+  get,
+  groupBy,
+  hasOwn,
+  normalizeUrlPath,
+  parseBooleanString,
+  startCase,
+  sumBy,
+  uniqBy,
+} from '@web-ts-toolkit/utils';
 
 const payload = {
   user: {
@@ -30,6 +39,7 @@ const payload = {
 };
 
 get(payload, 'user.profile.name');
+hasOwn(payload.user.profile, 'name');
 groupBy(
   [
     { type: 'fruit', name: 'apple' },
@@ -38,6 +48,14 @@ groupBy(
   ],
   'type',
 );
+uniqBy(
+  [
+    { id: 'a', name: 'Ada' },
+    { id: 'a', name: 'Ada Lovelace' },
+    { id: 'b', name: 'Grace' },
+  ],
+  'id',
+);
 startCase('api_response_time');
 sumBy([{ hours: 2 }, { hours: 3 }], 'hours');
 normalizeUrlPath('api//users');
@@ -46,8 +64,8 @@ parseBooleanString('true', false);
 
 ## Main Exports
 
-- object helpers: `get`, `set`, `pick`, `pickBy`, `omit`, `assign`, `cloneDeep`, `mapKeys`
-- collection helpers: `map`, `filter`, `reduce`, `find`, `flatten`, `uniq`, `orderBy`, `groupBy`, `sum`, `sumBy`
+- object helpers: `get`, `set`, `hasOwn`, `pick`, `pickBy`, `omit`, `omitBy`, `assign`, `cloneDeep`, `mapKeys`
+- collection helpers: `map`, `filter`, `reduce`, `find`, `flatten`, `uniq`, `uniqBy`, `orderBy`, `groupBy`, `sum`, `sumBy`
 - string helpers: `startCase`, `upperCase`
 - guards: `isArray`, `isPlainObject`, `isString`, `isPromise`
 - URL helpers: `addLeadingSlash`, `removeConsecutiveSlashesFromUrl`, `normalizeUrlPath`

package/index.d.mts

@@ -29,6 +29,8 @@ declare function get<T = unknown>(object: unknown, path: PropertyPath, defaultVa
 
 declare function groupBy<T>(collection: T[] | Record<string, T> | null | undefined, iteratee: string | number | ((value: T, key: number | string, collection: T[] | Record<string, T>) => unknown)): Record<string, T[]>;
 
+declare function hasOwn<TKey extends PropertyKey>(value: unknown, key: TKey): value is Record<TKey, unknown>;
+
 declare function intersection<T>(...arrays: Array<T[] | null | undefined>): T[];
 
 declare function intersectionBy<T>(...args: unknown[]): T[];
@@ -75,6 +77,8 @@ declare function noop(): void;
 
 declare function omit<T extends object>(object: T, paths: PropertyPath | PropertyPath[]): Partial<T>;
 
+declare function omitBy<TValue>(object: Record<string, TValue> | null | undefined, predicate: (value: TValue, key: string, object: Record<string, TValue>) => boolean): Record<string, TValue>;
+
 declare function parseBooleanString(str: string | undefined, defaultValue?: boolean): boolean | undefined;
 
 declare function orderBy<T>(collection: T[] | null | undefined, iteratees?: Array<string | number | ((value: T) => unknown)>, orders?: string[]): T[];
@@ -106,6 +110,8 @@ declare function toStringRecord(value: unknown): Record<string, string> | undefi
 
 declare function uniq<T>(array: T[] | null | undefined): T[];
 
+declare function uniqBy<T>(array: T[] | null | undefined, iteratee?: string | number | ((value: T, key: number, collection: T[]) => unknown)): T[];
+
 declare function upperCase(value: unknown): string;
 
-export { addLeadingSlash, arrayToRecord, assign, castArray, cloneDeep, compact, difference, filter, find, flatten, flattenDeep, forEach, get, groupBy, intersection, intersectionBy, isArray, isBoolean, isEmpty, isEqual, isFunction, isMatch, isNaNValue as isNaN, isNil, isNumber, isObject, isPlainObject, isPromise, isString, isUndefined, keys, map, mapKeys, mapValues, mapValuesAsync, noop, normalizeUrlPath, omit, orderBy, padEnd, parseBooleanString, pick, pickBy, reduce, removeConsecutiveSlashesFromUrl, set, startCase, sum, sumBy, toAsyncFn, toStringRecord, uniq, upperCase };
+export { addLeadingSlash, arrayToRecord, assign, castArray, cloneDeep, compact, difference, filter, find, flatten, flattenDeep, forEach, get, groupBy, hasOwn, intersection, intersectionBy, isArray, isBoolean, isEmpty, isEqual, isFunction, isMatch, isNaNValue as isNaN, isNil, isNumber, isObject, isPlainObject, isPromise, isString, isUndefined, keys, map, mapKeys, mapValues, mapValuesAsync, noop, normalizeUrlPath, omit, omitBy, orderBy, padEnd, parseBooleanString, pick, pickBy, reduce, removeConsecutiveSlashesFromUrl, set, startCase, sum, sumBy, toAsyncFn, toStringRecord, uniq, uniqBy, upperCase };

package/index.d.ts

@@ -29,6 +29,8 @@ declare function get<T = unknown>(object: unknown, path: PropertyPath, defaultVa
 
 declare function groupBy<T>(collection: T[] | Record<string, T> | null | undefined, iteratee: string | number | ((value: T, key: number | string, collection: T[] | Record<string, T>) => unknown)): Record<string, T[]>;
 
+declare function hasOwn<TKey extends PropertyKey>(value: unknown, key: TKey): value is Record<TKey, unknown>;
+
 declare function intersection<T>(...arrays: Array<T[] | null | undefined>): T[];
 
 declare function intersectionBy<T>(...args: unknown[]): T[];
@@ -75,6 +77,8 @@ declare function noop(): void;
 
 declare function omit<T extends object>(object: T, paths: PropertyPath | PropertyPath[]): Partial<T>;
 
+declare function omitBy<TValue>(object: Record<string, TValue> | null | undefined, predicate: (value: TValue, key: string, object: Record<string, TValue>) => boolean): Record<string, TValue>;
+
 declare function parseBooleanString(str: string | undefined, defaultValue?: boolean): boolean | undefined;
 
 declare function orderBy<T>(collection: T[] | null | undefined, iteratees?: Array<string | number | ((value: T) => unknown)>, orders?: string[]): T[];
@@ -106,6 +110,8 @@ declare function toStringRecord(value: unknown): Record<string, string> | undefi
 
 declare function uniq<T>(array: T[] | null | undefined): T[];
 
+declare function uniqBy<T>(array: T[] | null | undefined, iteratee?: string | number | ((value: T, key: number, collection: T[]) => unknown)): T[];
+
 declare function upperCase(value: unknown): string;
 
-export { addLeadingSlash, arrayToRecord, assign, castArray, cloneDeep, compact, difference, filter, find, flatten, flattenDeep, forEach, get, groupBy, intersection, intersectionBy, isArray, isBoolean, isEmpty, isEqual, isFunction, isMatch, isNaNValue as isNaN, isNil, isNumber, isObject, isPlainObject, isPromise, isString, isUndefined, keys, map, mapKeys, mapValues, mapValuesAsync, noop, normalizeUrlPath, omit, orderBy, padEnd, parseBooleanString, pick, pickBy, reduce, removeConsecutiveSlashesFromUrl, set, startCase, sum, sumBy, toAsyncFn, toStringRecord, uniq, upperCase };
+export { addLeadingSlash, arrayToRecord, assign, castArray, cloneDeep, compact, difference, filter, find, flatten, flattenDeep, forEach, get, groupBy, hasOwn, intersection, intersectionBy, isArray, isBoolean, isEmpty, isEqual, isFunction, isMatch, isNaNValue as isNaN, isNil, isNumber, isObject, isPlainObject, isPromise, isString, isUndefined, keys, map, mapKeys, mapValues, mapValuesAsync, noop, normalizeUrlPath, omit, omitBy, orderBy, padEnd, parseBooleanString, pick, pickBy, reduce, removeConsecutiveSlashesFromUrl, set, startCase, sum, sumBy, toAsyncFn, toStringRecord, uniq, uniqBy, upperCase };

package/index.js

@@ -33,6 +33,7 @@ __export(index_exports, {
   forEach: () => forEach,
   get: () => get,
   groupBy: () => groupBy,
+  hasOwn: () => hasOwn,
   intersection: () => intersection,
   intersectionBy: () => intersectionBy,
   isArray: () => isArray,
@@ -57,6 +58,7 @@ __export(index_exports, {
   noop: () => noop,
   normalizeUrlPath: () => normalizeUrlPath,
   omit: () => omit,
+  omitBy: () => omitBy,
   orderBy: () => orderBy,
   padEnd: () => padEnd,
   parseBooleanString: () => parseBooleanString,
@@ -71,6 +73,7 @@ __export(index_exports, {
   toAsyncFn: () => toAsyncFn,
   toStringRecord: () => toStringRecord,
   uniq: () => uniq,
+  uniqBy: () => uniqBy,
   upperCase: () => upperCase
 });
 module.exports = __toCommonJS(index_exports);
@@ -537,6 +540,14 @@ function groupBy(collection, iteratee) {
   return result;
 }
 
+// src/hasOwn.ts
+function hasOwn(value, key) {
+  if (value === null || value === void 0) {
+    return false;
+  }
+  return Object.hasOwn(Object(value), key);
+}
+
 // src/intersection.ts
 function intersection(...arrays) {
   const [first = [], ...rest] = arrays;
@@ -744,6 +755,23 @@ function omit(object, paths) {
   return result;
 }
 
+// src/omitBy.ts
+function omitBy(object, predicate) {
+  if (!object) {
+    return {};
+  }
+  const result = {};
+  const keys2 = Object.keys(object);
+  for (let index = 0; index < keys2.length; index++) {
+    const key = keys2[index];
+    const value = object[key];
+    if (!predicate(value, key, object)) {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+
 // src/parseBooleanString.ts
 function parseBooleanString(str, defaultValue) {
   return str ? str === "true" : defaultValue;
@@ -919,6 +947,26 @@ function uniq(array) {
   return baseUniq(array);
 }
 
+// src/uniqBy.ts
+function uniqBy(array, iteratee) {
+  if (!Array.isArray(array)) {
+    return [];
+  }
+  const callback = getIteratee(iteratee);
+  const result = [];
+  const seen = [];
+  for (let index = 0; index < array.length; index++) {
+    const value = array[index];
+    const computed = callback(value, index, array);
+    if (seen.some((entry) => sameValueZero(entry, computed))) {
+      continue;
+    }
+    seen.push(computed);
+    result.push(value);
+  }
+  return result;
+}
+
 // src/upperCase.ts
 function upperCase(value) {
   return words(value).join(" ").toUpperCase();
@@ -939,6 +987,7 @@ function upperCase(value) {
   forEach,
   get,
   groupBy,
+  hasOwn,
   intersection,
   intersectionBy,
   isArray,
@@ -963,6 +1012,7 @@ function upperCase(value) {
   noop,
   normalizeUrlPath,
   omit,
+  omitBy,
   orderBy,
   padEnd,
   parseBooleanString,
@@ -977,5 +1027,6 @@ function upperCase(value) {
   toAsyncFn,
   toStringRecord,
   uniq,
+  uniqBy,
   upperCase
 });

package/index.mjs

@@ -460,6 +460,14 @@ function groupBy(collection, iteratee) {
   return result;
 }
 
+// src/hasOwn.ts
+function hasOwn(value, key) {
+  if (value === null || value === void 0) {
+    return false;
+  }
+  return Object.hasOwn(Object(value), key);
+}
+
 // src/intersection.ts
 function intersection(...arrays) {
   const [first = [], ...rest] = arrays;
@@ -667,6 +675,23 @@ function omit(object, paths) {
   return result;
 }
 
+// src/omitBy.ts
+function omitBy(object, predicate) {
+  if (!object) {
+    return {};
+  }
+  const result = {};
+  const keys2 = Object.keys(object);
+  for (let index = 0; index < keys2.length; index++) {
+    const key = keys2[index];
+    const value = object[key];
+    if (!predicate(value, key, object)) {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+
 // src/parseBooleanString.ts
 function parseBooleanString(str, defaultValue) {
   return str ? str === "true" : defaultValue;
@@ -842,6 +867,26 @@ function uniq(array) {
   return baseUniq(array);
 }
 
+// src/uniqBy.ts
+function uniqBy(array, iteratee) {
+  if (!Array.isArray(array)) {
+    return [];
+  }
+  const callback = getIteratee(iteratee);
+  const result = [];
+  const seen = [];
+  for (let index = 0; index < array.length; index++) {
+    const value = array[index];
+    const computed = callback(value, index, array);
+    if (seen.some((entry) => sameValueZero(entry, computed))) {
+      continue;
+    }
+    seen.push(computed);
+    result.push(value);
+  }
+  return result;
+}
+
 // src/upperCase.ts
 function upperCase(value) {
   return words(value).join(" ").toUpperCase();
@@ -861,6 +906,7 @@ export {
   forEach,
   get,
   groupBy,
+  hasOwn,
   intersection,
   intersectionBy,
   isArray,
@@ -885,6 +931,7 @@ export {
   noop,
   normalizeUrlPath,
   omit,
+  omitBy,
   orderBy,
   padEnd,
   parseBooleanString,
@@ -899,5 +946,6 @@ export {
   toAsyncFn,
   toStringRecord,
   uniq,
+  uniqBy,
   upperCase
 };

package/package.json

@@ -2,7 +2,7 @@
   "name": "@web-ts-toolkit/utils",
   "description": "Shared collection, object, async, and URL helpers used across workspace packages",
   "homepage": "https://web-ts-toolkit.pages.dev/docs/packages/utils",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "sideEffects": false,
   "keywords": [
     "utilities",