@equinor/cpl-utils 0.2.0 → 0.2.2

package/dist/index.d.mts

@@ -113,6 +113,67 @@ declare function hasCircularDependency<T extends object>(items: T[], idKey: keyo
  */
 declare function itemIsDefined<T>(item: T): item is Exclude<typeof item, undefined>;
 
+type NestedRecord<K extends readonly string[]> = K extends [
+    infer First extends string,
+    ...infer Rest extends string[]
+] ? Record<First, NestedRecord<Rest>> : unknown;
+/**
+ * Checks if an object has a nested property chain, using Object.prototype.hasOwnProperty at each level.
+ * Returns true if all keys exist and are objects (except the last, which can be any value).
+ *
+ * @template K - Tuple of string keys representing the property chain.
+ * @param object - The object to check.
+ * @param keys - The property chain to check for.
+ * @returns {boolean} True if the nested property exists, false otherwise.
+ *
+ * @example
+ * // Basic usage
+ * const apiError = { error: { message: 'Not found' } }
+ * if (
+ *   objectHasOwnNestedProperty(apiError, 'error', 'message') &&
+ *   typeof apiError.error.message === 'string'
+ * ) {
+ *   return apiError.error.message
+ * }
+ *
+ * @example
+ * // Deeply nested object
+ * const data = { a: { b: { c: 42 } } }
+ * if (objectHasOwnNestedProperty(data, 'a', 'b', 'c')) {
+ *   console.log(data.a.b.c) // 42
+ * }
+ *
+
+ * @example
+ * // Usage in a try/catch block to extract a deeply nested error message
+ * try {
+ *   // ...some code that may throw
+ * } catch(error) {
+ *   if (
+ *     objectHasOwnNestedProperty(error, 'body', 'error', 'message') &&
+ *     typeof error.body.error.message === 'string'
+ *   ) {
+ *     setErrorMessage(error.body.error.message)
+ *   }
+ * }
+ *
+ * // Missing property
+ * const obj = { a: { b: {} } }
+ * objectHasOwnNestedProperty(obj, 'a', 'b', 'c') // false
+ *
+ * @example
+ * // Works with arrays as values
+ * const arrObj = { a: { b: [1, 2, 3] } }
+ * objectHasOwnNestedProperty(arrObj, 'a', 'b') // true
+ *
+ * @example
+ * // TypeScript type guard
+ * if (objectHasOwnNestedProperty(apiError, 'error', 'message')) {
+ *   // apiError is now typed as { error: { message: unknown } }
+ * }
+ */
+declare function objectHasOwnNestedProperty<K extends readonly string[]>(object: unknown, ...keys: K): object is NestedRecord<K>;
+
 /**
  * A better typed `Object.prototype.objectHasOwnOroperty`. It helps TypeScript
  * infer types when an object has multiple types with different properties.
@@ -144,4 +205,4 @@ declare function itemIsDefined<T>(item: T): item is Exclude<typeof item, undefin
  */
 declare function objectHasOwnProperty<Key extends PropertyKey>(object: object, key: Key): object is Record<Key, unknown>;
 
-export { type TreeNode, buildTreeNodes, hasCircularDependency, itemIsDefined, objectHasOwnProperty };
+export { type TreeNode, buildTreeNodes, hasCircularDependency, itemIsDefined, objectHasOwnNestedProperty, objectHasOwnProperty };

package/dist/index.d.ts

@@ -113,6 +113,67 @@ declare function hasCircularDependency<T extends object>(items: T[], idKey: keyo
  */
 declare function itemIsDefined<T>(item: T): item is Exclude<typeof item, undefined>;
 
+type NestedRecord<K extends readonly string[]> = K extends [
+    infer First extends string,
+    ...infer Rest extends string[]
+] ? Record<First, NestedRecord<Rest>> : unknown;
+/**
+ * Checks if an object has a nested property chain, using Object.prototype.hasOwnProperty at each level.
+ * Returns true if all keys exist and are objects (except the last, which can be any value).
+ *
+ * @template K - Tuple of string keys representing the property chain.
+ * @param object - The object to check.
+ * @param keys - The property chain to check for.
+ * @returns {boolean} True if the nested property exists, false otherwise.
+ *
+ * @example
+ * // Basic usage
+ * const apiError = { error: { message: 'Not found' } }
+ * if (
+ *   objectHasOwnNestedProperty(apiError, 'error', 'message') &&
+ *   typeof apiError.error.message === 'string'
+ * ) {
+ *   return apiError.error.message
+ * }
+ *
+ * @example
+ * // Deeply nested object
+ * const data = { a: { b: { c: 42 } } }
+ * if (objectHasOwnNestedProperty(data, 'a', 'b', 'c')) {
+ *   console.log(data.a.b.c) // 42
+ * }
+ *
+
+ * @example
+ * // Usage in a try/catch block to extract a deeply nested error message
+ * try {
+ *   // ...some code that may throw
+ * } catch(error) {
+ *   if (
+ *     objectHasOwnNestedProperty(error, 'body', 'error', 'message') &&
+ *     typeof error.body.error.message === 'string'
+ *   ) {
+ *     setErrorMessage(error.body.error.message)
+ *   }
+ * }
+ *
+ * // Missing property
+ * const obj = { a: { b: {} } }
+ * objectHasOwnNestedProperty(obj, 'a', 'b', 'c') // false
+ *
+ * @example
+ * // Works with arrays as values
+ * const arrObj = { a: { b: [1, 2, 3] } }
+ * objectHasOwnNestedProperty(arrObj, 'a', 'b') // true
+ *
+ * @example
+ * // TypeScript type guard
+ * if (objectHasOwnNestedProperty(apiError, 'error', 'message')) {
+ *   // apiError is now typed as { error: { message: unknown } }
+ * }
+ */
+declare function objectHasOwnNestedProperty<K extends readonly string[]>(object: unknown, ...keys: K): object is NestedRecord<K>;
+
 /**
  * A better typed `Object.prototype.objectHasOwnOroperty`. It helps TypeScript
  * infer types when an object has multiple types with different properties.
@@ -144,4 +205,4 @@ declare function itemIsDefined<T>(item: T): item is Exclude<typeof item, undefin
  */
 declare function objectHasOwnProperty<Key extends PropertyKey>(object: object, key: Key): object is Record<Key, unknown>;
 
-export { type TreeNode, buildTreeNodes, hasCircularDependency, itemIsDefined, objectHasOwnProperty };
+export { type TreeNode, buildTreeNodes, hasCircularDependency, itemIsDefined, objectHasOwnNestedProperty, objectHasOwnProperty };

package/dist/index.js

@@ -2,7 +2,21 @@
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -23,6 +37,7 @@ __export(index_exports, {
   buildTreeNodes: () => buildTreeNodes,
   hasCircularDependency: () => hasCircularDependency,
   itemIsDefined: () => itemIsDefined,
+  objectHasOwnNestedProperty: () => objectHasOwnNestedProperty,
   objectHasOwnProperty: () => objectHasOwnProperty
 });
 module.exports = __toCommonJS(index_exports);
@@ -72,7 +87,8 @@ function buildTreeNodes(items, idKey, parentIdKey, options = {}) {
     if (!objectHasOwnProperty(item, idKey)) {
       throw new Error(`Item is missing idKey named '${String(idKey)}'`);
     }
-    lookupTable.set(item[idKey], item);
+    const nodeCopy = __spreadValues({}, item);
+    lookupTable.set(item[idKey], nodeCopy);
   }
   const rootNodes = [];
   for (const item of lookupTable.values()) {
@@ -107,10 +123,26 @@ function buildTreeNodes(items, idKey, parentIdKey, options = {}) {
 function itemIsDefined(item) {
   return item !== void 0;
 }
+
+// src/object-has-own-nested-property.ts
+function objectHasOwnNestedProperty(object, ...keys) {
+  if (typeof object !== "object" || object === null) {
+    return false;
+  }
+  let currentObject = object;
+  for (const key of keys) {
+    if (!objectHasOwnProperty(currentObject, key) || typeof currentObject[key] !== "object" || currentObject[key] === null) {
+      return false;
+    }
+    currentObject = currentObject[key];
+  }
+  return true;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   buildTreeNodes,
   hasCircularDependency,
   itemIsDefined,
+  objectHasOwnNestedProperty,
   objectHasOwnProperty
 });

package/dist/index.mjs

@@ -1,3 +1,20 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+
 // src/has-circular-dependency.ts
 function hasCircularDependency(items, idKey, parentIdKey) {
   const parentMap = /* @__PURE__ */ new Map();
@@ -43,7 +60,8 @@ function buildTreeNodes(items, idKey, parentIdKey, options = {}) {
     if (!objectHasOwnProperty(item, idKey)) {
       throw new Error(`Item is missing idKey named '${String(idKey)}'`);
     }
-    lookupTable.set(item[idKey], item);
+    const nodeCopy = __spreadValues({}, item);
+    lookupTable.set(item[idKey], nodeCopy);
   }
   const rootNodes = [];
   for (const item of lookupTable.values()) {
@@ -78,9 +96,25 @@ function buildTreeNodes(items, idKey, parentIdKey, options = {}) {
 function itemIsDefined(item) {
   return item !== void 0;
 }
+
+// src/object-has-own-nested-property.ts
+function objectHasOwnNestedProperty(object, ...keys) {
+  if (typeof object !== "object" || object === null) {
+    return false;
+  }
+  let currentObject = object;
+  for (const key of keys) {
+    if (!objectHasOwnProperty(currentObject, key) || typeof currentObject[key] !== "object" || currentObject[key] === null) {
+      return false;
+    }
+    currentObject = currentObject[key];
+  }
+  return true;
+}
 export {
   buildTreeNodes,
   hasCircularDependency,
   itemIsDefined,
+  objectHasOwnNestedProperty,
   objectHasOwnProperty
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/cpl-utils",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "license": "MIT",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",