@ls-stack/utils 3.41.0 → 3.42.0

package/dist/{chunk-DTE2QMWE.js → chunk-GMJTLFM6.js}

@@ -5,6 +5,9 @@ function asNonPartial(obj) {
 function typedObjectEntries(obj) {
   return Object.entries(obj);
 }
+function strictTypedObjectEntries(obj) {
+  return Object.entries(obj);
+}
 function typedObjectKeys(obj) {
   return Object.keys(obj);
 }
@@ -33,10 +36,17 @@ function unionsAreTheSame(_diff) {
 function asPartialUndefinedValues(value) {
   return value;
 }
+function isNonEmptyArray(array) {
+  return array.length > 0;
+}
+function objectHasKey(obj, key) {
+  return key in obj;
+}
 
 export {
   asNonPartial,
   typedObjectEntries,
+  strictTypedObjectEntries,
   typedObjectKeys,
   asType,
   narrowStringToUnion,
@@ -44,5 +54,7 @@ export {
   isSubTypeOf,
   isObjKey,
   unionsAreTheSame,
-  asPartialUndefinedValues
+  asPartialUndefinedValues,
+  isNonEmptyArray,
+  objectHasKey
 };

package/dist/{chunk-23KPGKDT.js → chunk-Y45CE75W.js}

@@ -1,6 +1,6 @@
 import {
   typedObjectEntries
-} from "./chunk-DTE2QMWE.js";
+} from "./chunk-GMJTLFM6.js";
 import {
   sortBy
 } from "./chunk-27AL66CH.js";

package/dist/objUtils.js

@@ -8,8 +8,8 @@ import {
   pick,
   rejectObjUndefinedValues,
   sortObjectKeys
-} from "./chunk-23KPGKDT.js";
-import "./chunk-DTE2QMWE.js";
+} from "./chunk-Y45CE75W.js";
+import "./chunk-GMJTLFM6.js";
 import "./chunk-27AL66CH.js";
 import "./chunk-C2SVCIWE.js";
 import "./chunk-JF2MDHOJ.js";

package/dist/testUtils.js

@@ -4,8 +4,8 @@ import {
 import {
   omit,
   pick
-} from "./chunk-23KPGKDT.js";
-import "./chunk-DTE2QMWE.js";
+} from "./chunk-Y45CE75W.js";
+import "./chunk-GMJTLFM6.js";
 import "./chunk-IATIXMCE.js";
 import {
   deepEqual

package/dist/typingFnUtils.cjs

@@ -23,9 +23,12 @@ __export(typingFnUtils_exports, {
   asNonPartial: () => asNonPartial,
   asPartialUndefinedValues: () => asPartialUndefinedValues,
   asType: () => asType,
+  isNonEmptyArray: () => isNonEmptyArray,
   isObjKey: () => isObjKey,
   isSubTypeOf: () => isSubTypeOf,
   narrowStringToUnion: () => narrowStringToUnion,
+  objectHasKey: () => objectHasKey,
+  strictTypedObjectEntries: () => strictTypedObjectEntries,
   typeOnRightExtendsLeftType: () => typeOnRightExtendsLeftType,
   typedObjectEntries: () => typedObjectEntries,
   typedObjectKeys: () => typedObjectKeys,
@@ -38,6 +41,9 @@ function asNonPartial(obj) {
 function typedObjectEntries(obj) {
   return Object.entries(obj);
 }
+function strictTypedObjectEntries(obj) {
+  return Object.entries(obj);
+}
 function typedObjectKeys(obj) {
   return Object.keys(obj);
 }
@@ -66,14 +72,23 @@ function unionsAreTheSame(_diff) {
 function asPartialUndefinedValues(value) {
   return value;
 }
+function isNonEmptyArray(array) {
+  return array.length > 0;
+}
+function objectHasKey(obj, key) {
+  return key in obj;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   asNonPartial,
   asPartialUndefinedValues,
   asType,
+  isNonEmptyArray,
   isObjKey,
   isSubTypeOf,
   narrowStringToUnion,
+  objectHasKey,
+  strictTypedObjectEntries,
   typeOnRightExtendsLeftType,
   typedObjectEntries,
   typedObjectKeys,

package/dist/typingFnUtils.d.cts

@@ -10,6 +10,15 @@ declare function asNonPartial<T extends Record<string, unknown>>(obj: T): NonPar
 declare function typedObjectEntries<T extends Record<string, unknown>>(obj: T): NonNullable<{
     [K in keyof T]: [K, T[K]];
 }[keyof T]>[];
+/**
+ * A wrapper to Object.entries with a better typing inference, but with strict
+ * typing narrowing keys to strings.
+ *
+ * @param obj
+ */
+declare function strictTypedObjectEntries<T extends Record<string, unknown>>(obj: T): NonNullable<{
+    [K in keyof T]: [K & string, T[K]];
+}[keyof T]>[];
 /**
  * A wrapper to Object.keys with a better typing inference
  *
@@ -68,5 +77,17 @@ type UnionDiff<T, U> = [
  */
 declare function unionsAreTheSame<T, U>(_diff: UnionDiff<T, U>): void;
 declare function asPartialUndefinedValues<T extends Record<string, unknown>>(value: PartialPossiblyUndefinedValues<T>): T;
+/** A type representing an array that is guaranteed to have at least one element. */
+type NonEmptyArray<T> = [T, ...T[]];
+/**
+ * Type guard to check if an array has at least one element.
+ *
+ * @param array - The array to check
+ * @returns True if the array is non-empty, false otherwise
+ */
+declare function isNonEmptyArray<T>(array: T[]): array is NonEmptyArray<T>;
+declare function objectHasKey<T extends string>(obj: object, key: T): obj is object & {
+    [K in T]: unknown;
+};
 
-export { asNonPartial, asPartialUndefinedValues, asType, isObjKey, isSubTypeOf, narrowStringToUnion, typeOnRightExtendsLeftType, typedObjectEntries, typedObjectKeys, unionsAreTheSame };
+export { type NonEmptyArray, asNonPartial, asPartialUndefinedValues, asType, isNonEmptyArray, isObjKey, isSubTypeOf, narrowStringToUnion, objectHasKey, strictTypedObjectEntries, typeOnRightExtendsLeftType, typedObjectEntries, typedObjectKeys, unionsAreTheSame };

package/dist/typingFnUtils.d.ts

@@ -10,6 +10,15 @@ declare function asNonPartial<T extends Record<string, unknown>>(obj: T): NonPar
 declare function typedObjectEntries<T extends Record<string, unknown>>(obj: T): NonNullable<{
     [K in keyof T]: [K, T[K]];
 }[keyof T]>[];
+/**
+ * A wrapper to Object.entries with a better typing inference, but with strict
+ * typing narrowing keys to strings.
+ *
+ * @param obj
+ */
+declare function strictTypedObjectEntries<T extends Record<string, unknown>>(obj: T): NonNullable<{
+    [K in keyof T]: [K & string, T[K]];
+}[keyof T]>[];
 /**
  * A wrapper to Object.keys with a better typing inference
  *
@@ -68,5 +77,17 @@ type UnionDiff<T, U> = [
  */
 declare function unionsAreTheSame<T, U>(_diff: UnionDiff<T, U>): void;
 declare function asPartialUndefinedValues<T extends Record<string, unknown>>(value: PartialPossiblyUndefinedValues<T>): T;
+/** A type representing an array that is guaranteed to have at least one element. */
+type NonEmptyArray<T> = [T, ...T[]];
+/**
+ * Type guard to check if an array has at least one element.
+ *
+ * @param array - The array to check
+ * @returns True if the array is non-empty, false otherwise
+ */
+declare function isNonEmptyArray<T>(array: T[]): array is NonEmptyArray<T>;
+declare function objectHasKey<T extends string>(obj: object, key: T): obj is object & {
+    [K in T]: unknown;
+};
 
-export { asNonPartial, asPartialUndefinedValues, asType, isObjKey, isSubTypeOf, narrowStringToUnion, typeOnRightExtendsLeftType, typedObjectEntries, typedObjectKeys, unionsAreTheSame };
+export { type NonEmptyArray, asNonPartial, asPartialUndefinedValues, asType, isNonEmptyArray, isObjKey, isSubTypeOf, narrowStringToUnion, objectHasKey, strictTypedObjectEntries, typeOnRightExtendsLeftType, typedObjectEntries, typedObjectKeys, unionsAreTheSame };

package/dist/typingFnUtils.js

@@ -2,21 +2,27 @@ import {
   asNonPartial,
   asPartialUndefinedValues,
   asType,
+  isNonEmptyArray,
   isObjKey,
   isSubTypeOf,
   narrowStringToUnion,
+  objectHasKey,
+  strictTypedObjectEntries,
   typeOnRightExtendsLeftType,
   typedObjectEntries,
   typedObjectKeys,
   unionsAreTheSame
-} from "./chunk-DTE2QMWE.js";
+} from "./chunk-GMJTLFM6.js";
 export {
   asNonPartial,
   asPartialUndefinedValues,
   asType,
+  isNonEmptyArray,
   isObjKey,
   isSubTypeOf,
   narrowStringToUnion,
+  objectHasKey,
+  strictTypedObjectEntries,
   typeOnRightExtendsLeftType,
   typedObjectEntries,
   typedObjectKeys,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ls-stack/utils",
   "description": "Universal TypeScript utilities for browser and Node.js",
-  "version": "3.41.0",
+  "version": "3.42.0",
   "license": "MIT",
   "files": [
     "dist",