is-kit 1.1.11 → 1.1.13

package/README.md

@@ -162,15 +162,15 @@ isInfiniteNumber(1); // false
 - **Define once**: `define<T>(fn)` turns a plain function into a type guard.
 - **Upgrade predicates**: `predicateToRefine(fn)` adds narrowing.
 - **Compose freely**: `and`, `or`, `not`, `oneOf`, `arrayOf`, `struct` …
-- **Stay ergonomic**: helpers like `nullable`, `optional`, `equals`, `safeParse`, `narrowKeyTo`.
+- **Stay ergonomic**: helpers like `nullable`, `optional`, `equals`, `safeParse`, `hasKey`, `narrowKeyTo`.
 
-### Key Narrowing
+### Key Helpers
 
-`equalsBy` preserves the base type and does not narrow selected fields to literals.
-When you need to narrow a property to a specific literal value, use `narrowKeyTo`.
+Use `hasKey` to check for a required own property before refining, and
+`narrowKeyTo` when you need to narrow a property to a specific literal value.
 
 ```ts
-import { narrowKeyTo, or, struct } from 'is-kit';
+import { hasKey, isString, isNumber, narrowKeyTo, or, struct } from 'is-kit';
 
 // Base guard (e.g., via struct)
 type User = { id: string; age: number; role: 'admin' | 'guest' | 'trial' };
@@ -180,12 +180,17 @@ const isUser = struct({
   role: oneOfValues('admin', 'guest', 'trial')
 });
 
+const hasRole = hasKey('role');
 const byRole = narrowKeyTo(isUser, 'role');
 const isGuest = byRole('guest'); // Readonly<User> & { role: 'guest' }
 const isTrial = byRole('trial'); // Readonly<User> & { role: 'trial' }
 const isGuestOrTrial = or(isGuest, isTrial);
 
 declare const value: unknown;
+if (hasRole(value)) {
+  value.role;
+}
+
 if (isGuestOrTrial(value)) {
   // value.role is 'guest' | 'trial'
 }

package/dist/index.d.mts

@@ -451,6 +451,13 @@ declare const isURL: Predicate<URL>;
  */
 declare const isBlob: Predicate<Blob>;
 
+/**
+ * Checks whether a value has the specified own key.
+ *
+ * @param key Property key to check.
+ * @returns Predicate narrowing to an object with the key present.
+ */
+declare const hasKey: <K extends PropertyKey>(key: K) => Predicate<Record<K, unknown>>;
 /**
  * Builds a guard that narrows a specific key to the provided literal value.
  *
@@ -466,11 +473,11 @@ declare const isBlob: Predicate<Blob>;
 declare function narrowKeyTo<A, K extends keyof A>(guard: Guard<A>, key: K): <const T extends A[K]>(target: T) => Predicate<A & Record<K, T>>;
 
 /**
- * Converts an array of guards to plain boolean predicates for iteration helpers.
+ * Converts predicates to plain boolean predicates for iteration helpers.
  *
- * @param guards Guards to be treated as simple predicates.
+ * @param predicates Predicates to be treated as simple boolean functions.
  * @returns Readonly array of boolean-returning functions.
  */
-declare const toBooleanPredicates: (guards: readonly Guard<unknown>[]) => ReadonlyArray<(value: unknown) => boolean>;
+declare const toBooleanPredicates: <A>(predicates: readonly ((value: A) => boolean)[]) => ReadonlyArray<(value: A) => boolean>;
 
-export { type ChainResult, type Guard, type GuardedOf, type GuardedWithin, type InferSchema, type OutOfGuards, type ParseResult, type Predicate, type Primitive, type Refine, type RefineChain, type Refinement, type Schema, and, andAll, arrayOf, define, equals, equalsBy, equalsKey, guardIn, isArray, isArrayBuffer, isAsyncIterable, isBigInt, isBlob, isBoolean, isDataView, isDate, isError, isFiniteNumber, isFunction, isInfiniteNumber, isInteger, isIterable, isMap, isNaN, isNegative, isNull, isNumber, isNumberPrimitive, isObject, isPlainObject, isPositive, isPrimitive, isPromiseLike, isRegExp, isSafeInteger, isSet, isString, isSymbol, isTypedArray, isURL, isUndefined, isWeakMap, isWeakSet, isZero, narrowKeyTo, nonNull, not, nullable, nullish, oneOf, oneOfValues, optional, or, predicateToRefine, recordOf, required, safeParse, safeParseWith, struct, toBooleanPredicates, tupleOf };
+export { type ChainResult, type Guard, type GuardedOf, type GuardedWithin, type InferSchema, type OutOfGuards, type ParseResult, type Predicate, type Primitive, type Refine, type RefineChain, type Refinement, type Schema, and, andAll, arrayOf, define, equals, equalsBy, equalsKey, guardIn, hasKey, isArray, isArrayBuffer, isAsyncIterable, isBigInt, isBlob, isBoolean, isDataView, isDate, isError, isFiniteNumber, isFunction, isInfiniteNumber, isInteger, isIterable, isMap, isNaN, isNegative, isNull, isNumber, isNumberPrimitive, isObject, isPlainObject, isPositive, isPrimitive, isPromiseLike, isRegExp, isSafeInteger, isSet, isString, isSymbol, isTypedArray, isURL, isUndefined, isWeakMap, isWeakSet, isZero, narrowKeyTo, nonNull, not, nullable, nullish, oneOf, oneOfValues, optional, or, predicateToRefine, recordOf, required, safeParse, safeParseWith, struct, toBooleanPredicates, tupleOf };

package/dist/index.d.ts

@@ -451,6 +451,13 @@ declare const isURL: Predicate<URL>;
  */
 declare const isBlob: Predicate<Blob>;
 
+/**
+ * Checks whether a value has the specified own key.
+ *
+ * @param key Property key to check.
+ * @returns Predicate narrowing to an object with the key present.
+ */
+declare const hasKey: <K extends PropertyKey>(key: K) => Predicate<Record<K, unknown>>;
 /**
  * Builds a guard that narrows a specific key to the provided literal value.
  *
@@ -466,11 +473,11 @@ declare const isBlob: Predicate<Blob>;
 declare function narrowKeyTo<A, K extends keyof A>(guard: Guard<A>, key: K): <const T extends A[K]>(target: T) => Predicate<A & Record<K, T>>;
 
 /**
- * Converts an array of guards to plain boolean predicates for iteration helpers.
+ * Converts predicates to plain boolean predicates for iteration helpers.
  *
- * @param guards Guards to be treated as simple predicates.
+ * @param predicates Predicates to be treated as simple boolean functions.
  * @returns Readonly array of boolean-returning functions.
  */
-declare const toBooleanPredicates: (guards: readonly Guard<unknown>[]) => ReadonlyArray<(value: unknown) => boolean>;
+declare const toBooleanPredicates: <A>(predicates: readonly ((value: A) => boolean)[]) => ReadonlyArray<(value: A) => boolean>;
 
-export { type ChainResult, type Guard, type GuardedOf, type GuardedWithin, type InferSchema, type OutOfGuards, type ParseResult, type Predicate, type Primitive, type Refine, type RefineChain, type Refinement, type Schema, and, andAll, arrayOf, define, equals, equalsBy, equalsKey, guardIn, isArray, isArrayBuffer, isAsyncIterable, isBigInt, isBlob, isBoolean, isDataView, isDate, isError, isFiniteNumber, isFunction, isInfiniteNumber, isInteger, isIterable, isMap, isNaN, isNegative, isNull, isNumber, isNumberPrimitive, isObject, isPlainObject, isPositive, isPrimitive, isPromiseLike, isRegExp, isSafeInteger, isSet, isString, isSymbol, isTypedArray, isURL, isUndefined, isWeakMap, isWeakSet, isZero, narrowKeyTo, nonNull, not, nullable, nullish, oneOf, oneOfValues, optional, or, predicateToRefine, recordOf, required, safeParse, safeParseWith, struct, toBooleanPredicates, tupleOf };
+export { type ChainResult, type Guard, type GuardedOf, type GuardedWithin, type InferSchema, type OutOfGuards, type ParseResult, type Predicate, type Primitive, type Refine, type RefineChain, type Refinement, type Schema, and, andAll, arrayOf, define, equals, equalsBy, equalsKey, guardIn, hasKey, isArray, isArrayBuffer, isAsyncIterable, isBigInt, isBlob, isBoolean, isDataView, isDate, isError, isFiniteNumber, isFunction, isInfiniteNumber, isInteger, isIterable, isMap, isNaN, isNegative, isNull, isNumber, isNumberPrimitive, isObject, isPlainObject, isPositive, isPrimitive, isPromiseLike, isRegExp, isSafeInteger, isSet, isString, isSymbol, isTypedArray, isURL, isUndefined, isWeakMap, isWeakSet, isZero, narrowKeyTo, nonNull, not, nullable, nullish, oneOf, oneOfValues, optional, or, predicateToRefine, recordOf, required, safeParse, safeParseWith, struct, toBooleanPredicates, tupleOf };

package/dist/index.js

@@ -28,6 +28,7 @@ __export(index_exports, {
   equalsBy: () => equalsBy,
   equalsKey: () => equalsKey,
   guardIn: () => guardIn,
+  hasKey: () => hasKey,
   isArray: () => isArray,
   isArrayBuffer: () => isArrayBuffer,
   isAsyncIterable: () => isAsyncIterable,
@@ -93,7 +94,7 @@ function define(fn) {
 var predicateToRefine = (fn) => (value) => fn(value);
 
 // src/utils/to-boolean-predicates.ts
-var toBooleanPredicates = (guards) => guards;
+var toBooleanPredicates = (predicates) => predicates;
 
 // src/core/logic.ts
 function and(precondition, condition) {
@@ -105,9 +106,9 @@ function and(precondition, condition) {
   };
 }
 function andAll(precondition, ...steps) {
-  const boolSteps = steps;
   return function(input) {
-    return precondition(input) && boolSteps.every((step) => step(input));
+    if (!precondition(input)) return false;
+    return applyRefinements(input, steps);
   };
 }
 function or(...guards) {
@@ -126,6 +127,13 @@ function guardIn() {
 function not(fn) {
   return (input) => !fn(input);
 }
+function applyRefinements(value, steps) {
+  if (!steps || steps.length === 0) return true;
+  for (const step of steps) {
+    if (!step(value)) return false;
+  }
+  return true;
+}
 
 // src/core/nullish.ts
 function nullable(fn) {
@@ -370,6 +378,9 @@ function oneOfValues(...args) {
 }
 
 // src/core/key.ts
+var hasKey = (key) => define(
+  (input) => isObject(input) && Object.prototype.hasOwnProperty.call(input, key)
+);
 function narrowKeyTo(guard, key) {
   return function(target) {
     const keyEquals = equalsKey(key, target);
@@ -388,6 +399,7 @@ function narrowKeyTo(guard, key) {
   equalsBy,
   equalsKey,
   guardIn,
+  hasKey,
   isArray,
   isArrayBuffer,
   isAsyncIterable,

package/dist/index.mjs

@@ -7,7 +7,7 @@ function define(fn) {
 var predicateToRefine = (fn) => (value) => fn(value);
 
 // src/utils/to-boolean-predicates.ts
-var toBooleanPredicates = (guards) => guards;
+var toBooleanPredicates = (predicates) => predicates;
 
 // src/core/logic.ts
 function and(precondition, condition) {
@@ -19,9 +19,9 @@ function and(precondition, condition) {
   };
 }
 function andAll(precondition, ...steps) {
-  const boolSteps = steps;
   return function(input) {
-    return precondition(input) && boolSteps.every((step) => step(input));
+    if (!precondition(input)) return false;
+    return applyRefinements(input, steps);
   };
 }
 function or(...guards) {
@@ -40,6 +40,13 @@ function guardIn() {
 function not(fn) {
   return (input) => !fn(input);
 }
+function applyRefinements(value, steps) {
+  if (!steps || steps.length === 0) return true;
+  for (const step of steps) {
+    if (!step(value)) return false;
+  }
+  return true;
+}
 
 // src/core/nullish.ts
 function nullable(fn) {
@@ -284,6 +291,9 @@ function oneOfValues(...args) {
 }
 
 // src/core/key.ts
+var hasKey = (key) => define(
+  (input) => isObject(input) && Object.prototype.hasOwnProperty.call(input, key)
+);
 function narrowKeyTo(guard, key) {
   return function(target) {
     const keyEquals = equalsKey(key, target);
@@ -301,6 +311,7 @@ export {
   equalsBy,
   equalsKey,
   guardIn,
+  hasKey,
   isArray,
   isArrayBuffer,
   isAsyncIterable,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "is-kit",
-  "version": "1.1.11",
+  "version": "1.1.13",
   "description": "Make 'isXXX' easier. Let's make your code type safe and more readable!",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",