Essential utility functions for object manipulation and data validation.
Creates a new object by picking only the specified properties from the original object.
Creates a new object by omitting specified properties from the original object.
Creates a new object containing only the non-function properties from the original object.
Checks if a value is present (not empty) and provides TypeScript type narrowing.
A value is considered present if it is NOT:
undefinednull- An empty string
''
import { pick } from '@agape/util';
const user = { id: 1, name: 'John', email: '[email protected]' };
pick(user, ['id', 'name']);
// Result: { id: 1, name: 'John' }import { omit } from '@agape/util';
const user = { id: 1, name: 'John', email: '[email protected]', password: 'secret' };
omit(user, ['password']);
// Result: { id: 1, name: 'John', email: 'john@example.com' }import { properties } from '@agape/util';
const employee = {
id: 1,
name: 'John',
getFullName() { return this.name; }
};
properties(employee);
// Result: { id: 1, name: 'John' }import { isPresent } from '@agape/util';
isPresent('hello'); // true
isPresent(''); // false
isPresent(null); // false
isPresent(undefined); // falseThis function acts as a type guard, allowing TypeScript to narrow types in conditional statements.
function processValue(value: number | undefined) {
if (isPresent(value)) {
// TypeScript knows value is definitely a number here
return value + 1; // ✅ No type errors
}
// TypeScript knows value is undefined here
}See the full API documentation at agape.dev/api.
This package is part of the Agape Toolkit - a comprehensive collection of TypeScript utilities and libraries for modern web development.