@pixpilot/object 1.0.2 → 1.1.5

package/README.md

@@ -1,3 +1,74 @@
 # @pixpilot/object
 
-## Usage Add usage instructions here.
+A collection of utility functions for working with JavaScript objects.
+
+## Installation
+
+```bash
+pnpm add @pixpilot/object
+```
+
+## Usage
+
+```typescript
+import {
+  deepClone,
+  isObject,
+  keysToCamelCase,
+  keysToSnakeCase,
+  omit,
+  pick,
+} from '@pixpilot/object';
+
+// Convert object keys
+const obj = { user_name: 'john', user_details: { first_name: 'John' } };
+const camelCaseObj = keysToCamelCase(obj);
+// { userName: 'john', userDetails: { firstName: 'John' } }
+
+// Manipulate objects
+const picked = pick({ a: 1, b: 2, c: 3 }, ['a', 'c']); // { a: 1, c: 3 }
+const omitted = omit({ a: 1, b: 2, c: 3 }, ['b']); // { a: 1, c: 3 }
+
+// Clone deeply
+const cloned = deepClone({ a: { b: { c: 1 } } });
+
+// Type guards
+if (isObject(value)) {
+  // value is typed as Record<string, unknown>
+}
+```
+
+## API
+
+### Type Guards
+
+- `isObject(value: unknown): value is Record<string, unknown>` - Check if value is an object
+- `isPlainObject(value: unknown): value is Record<string, unknown>` - Check if value is a plain object
+- `isEmptyObject(value: unknown): boolean` - Check if object is empty
+
+### Key Transformation
+
+- `keysToCamelCase<T>(obj: T): KeysToCamelCase<T>` - Convert all keys to camelCase
+- `keysToSnakeCase<T>(obj: T): KeysToSnakeCase<T>` - Convert all keys to snake_case
+
+### Object Manipulation
+
+- `pick<T, K>(obj: T, keys: K[]): Pick<T, K>` - Pick specific keys from object
+- `omit<T, K>(obj: T, keys: K[]): Omit<T, K>` - Omit specific keys from object
+- `merge<T, U>(target: T, source: U): T & U` - Deep merge two objects
+- `get<T>(obj: object, path: string, defaultValue?: T): T | undefined` - Get nested value by path
+- `set<T>(obj: T, path: string, value: unknown): T` - Set nested value by path
+- `has(obj: object, path: string): boolean` - Check if nested path exists
+- `flatKeys(obj: object, prefix?: string): string[]` - Get all keys including nested paths
+- `deepClone<T>(obj: T): T` - Deep clone an object
+- `deepEqual(obj1: unknown, obj2: unknown): boolean` - Deep equality comparison
+- `mapValues<T, U>(obj: T, fn: (value, key) => U): Record<keyof T, U>` - Map over object values
+- `mapKeys<T>(obj: T, fn: (key) => string): Record<string, T[keyof T]>` - Map over object keys
+
+## Contributing
+
+We welcome contributions! Please see the [main contributing guide](../../CONTRIBUTING.md) for details.
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](../../LICENSE) file for details.

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";var e=require("./keys-to-camel-case.cjs"),s=require("./keys-to-snake-case.cjs");exports.keysToCamelCase=e.keysToCamelCase,exports.keysToSnakeCase=s.keysToSnakeCase;
+"use strict";const e=/([\p{Ll}\d])(\p{Lu})/gu,t=/(\p{Lu})([\p{Lu}][\p{Ll}])/gu,r=/(\d)\p{Ll}|(\p{L})\d/u,n=/[^\p{L}\d]+/giu,o="$1\0$2";function c(r){let c=r.trim();c=c.replace(e,o).replace(t,o),c=c.replace(n,"\0");let s=0,u=c.length;for(;"\0"===c.charAt(s);)s++;if(s===u)return[];for(;"\0"===c.charAt(u-1);)u--;return c.slice(s,u).split(/\0/g)}function s(e){const t=c(e);for(let e=0;e<t.length;e++){const n=t[e],o=r.exec(n);if(o){const r=o.index+(o[1]??o[2]).length;t.splice(e,1,n.slice(0,r),n.slice(r))}}return t}function u(e){return!1===e?e=>e.toLowerCase():t=>t.toLocaleLowerCase(e)}function f(e,t={}){const r=t.split??(t.separateNumbers?s:c),n=t.prefixCharacters??"",o=t.suffixCharacters??"";let u=0,f=e.length;for(;u<e.length;){const t=e.charAt(u);if(!n.includes(t))break;u++}for(;f>u;){const t=f-1,r=e.charAt(t);if(!o.includes(r))break;f=t}return[e.slice(0,u),r(e.slice(u,f)),e.slice(f)]}function i(e){return function(e,t){const[r,n,o]=f(e,t),c=u(t?.locale),s=function(e){return t=>t.toLocaleUpperCase(e)}(t?.locale),i=function(e,t){return(r,n)=>{const o=r[0];return(n>0&&o>="0"&&o<="9"?"_"+o:t(o))+e(r.slice(1))}}(c,s);return r+n.map((e,t)=>0===t?c(e):i(e,t)).join("")+o}(e)}function l(e){return function(e,t){const[r,n,o]=f(e,t);return r+n.map(u(t?.locale)).join(t?.delimiter??" ")+o}(e,{delimiter:"_"})}function p(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var a,y={exports:{}};var g=(a||(a=1,function(e){const t=Object.getPrototypeOf({});function r(){return function(e){return!("object"!=typeof e||null===e||e instanceof RegExp||e instanceof Date)}}function n(e){function n(e){return"constructor"!==e&&"prototype"!==e&&"__proto__"!==e}const o=Object.prototype.propertyIsEnumerable,c=e?.symbols?function(e){const t=Object.keys(e),r=Object.getOwnPropertySymbols(e);for(let n=0,c=r.length;n<c;++n)o.call(e,r[n])&&t.push(r[n]);return t}:Object.keys,s="function"==typeof e?.cloneProtoObject?e.cloneProtoObject:void 0,u="function"==typeof e?.isMergeableObject?e.isMergeableObject:r(),f=e&&"function"==typeof e.mergeArray?e.mergeArray({clone:i,deepmerge:l,getKeys:c,isMergeableObject:u}):function(e,t){const r=e.length,n=t.length;let o=0;const c=new Array(r+n);for(;o<r;++o)c[o]=i(e[o]);for(o=0;o<n;++o)c[o+r]=i(t[o]);return c};function i(e){return u(e)?Array.isArray(e)?function(e){let t=0;const r=e.length,n=new Array(r);for(;t<r;++t)n[t]=i(e[t]);return n}(e):function(e){const r={};if(s&&Object.getPrototypeOf(e)!==t)return s(e);const o=c(e);let u,f,l;for(u=0,f=o.length;u<f;++u)n(l=o[u])&&(r[l]=i(e[l]));return r}(e):e}function l(e,r){const o=Array.isArray(r),p=Array.isArray(e);return"object"!=typeof(a=r)||null===a?r:u(e)?o&&p?f(e,r):o!==p?i(r):function(e,r){const o={},f=c(e),p=c(r);let a,y,g;for(a=0,y=f.length;a<y;++a)n(g=f[a])&&-1===p.indexOf(g)&&(o[g]=i(e[g]));for(a=0,y=p.length;a<y;++a)n(g=p[a])&&(g in e?-1!==f.indexOf(g)&&(s&&u(r[g])&&Object.getPrototypeOf(r[g])!==t?o[g]=s(r[g]):o[g]=l(e[g],r[g])):o[g]=i(r[g]));return o}(e,r):i(r);var a}return e?.all?function(){switch(arguments.length){case 0:return{};case 1:return i(arguments[0]);case 2:return l(arguments[0],arguments[1])}let e;for(let t=0,r=arguments.length;t<r;++t)e=l(e,arguments[t]);return e}:l}e.exports=n,e.exports.default=n,e.exports.deepmerge=n,Object.defineProperty(e.exports,"isMergeableObject",{get:r})}(y)),y.exports);function b(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}const j=p(g)();exports.deepClone=function e(t){if(null===t||"object"!=typeof t)return t;if(t instanceof Date)return new Date(t.getTime());if(t instanceof RegExp)return new RegExp(t.source,t.flags);if(Array.isArray(t))return t.map(t=>e(t));const r={};for(const[n,o]of Object.entries(t))r[n]=e(o);return r},exports.deepEqual=function e(t,r){if(t===r)return!0;if(typeof t!=typeof r)return!1;if(null===t||null===r)return!1;if(t instanceof Date&&r instanceof Date)return t.getTime()===r.getTime();if(Array.isArray(t)&&Array.isArray(r))return t.length===r.length&&t.every((t,n)=>e(t,r[n]));if("object"==typeof t&&"object"==typeof r){const n=Object.keys(t),o=Object.keys(r);return n.length===o.length&&n.every(n=>e(t[n],r[n]))}return!1},exports.deepmerge=j,exports.flatKeys=function e(t,r=""){const n=[];for(const[o,c]of Object.entries(t)){const t=r?`${r}.${o}`:o;b(c)?n.push(...e(c,t)):n.push(t)}return n},exports.get=function(e,t,r){const n=t.split(".");let o=e;for(const e of n){if(null==o||"object"!=typeof o||!(e in o))return r;o=o[e]}return o},exports.has=function(e,t){const r=t.split(".");let n=e;for(const e of r){if(null==n||"object"!=typeof n||!(e in n))return!1;n=n[e]}return!0},exports.isEmptyObject=function(e){return b(e)&&0===Object.keys(e).length},exports.isObject=b,exports.isPlainObject=function(e){if(!b(e))return!1;const t=Object.getPrototypeOf(e);return null===t||t===Object.prototype},exports.keysToCamelCase=function e(t){if(Array.isArray(t))return t.map(e);if(null===t||"object"!=typeof t)return t;const r={};for(const[n,o]of Object.entries(t)){r[i(n)]=e(o)}return r},exports.keysToSnakeCase=function e(t){if(Array.isArray(t))return t.map(e);if(null===t||"object"!=typeof t)return t;const r={};for(const[n,o]of Object.entries(t)){r[l(n)]=e(o)}return r},exports.mapKeys=function(e,t){const r={};for(const[n,o]of Object.entries(e)){r[t(n)]=o}return r},exports.mapValues=function(e,t){const r={};for(const[n,o]of Object.entries(e))r[n]=t(o,n);return r},exports.merge=function(e,t){return j(e,t)},exports.mergeAll=function(...e){if(0===e.length)return{};if(1===e.length)return e[0]??{};let t={};for(const r of e)t=j(t,r);return t},exports.omit=function(e,t){const r={...e};for(const e of t)delete r[e];return r},exports.pick=function(e,t){const r={};for(const n of t)n in e&&(r[n]=e[n]);return r},exports.set=function(e,t,r){const n=t.split("."),o=n.pop();if(null==o||0===o.length)return e;let c=e;for(const e of n)e in c&&b(c[e])||(c[e]={}),c=c[e];return c[o]=r,e};

package/dist/index.d.ts

@@ -1,2 +1,4 @@
 export * from './keys-to-camel-case';
 export * from './keys-to-snake-case';
+export * from './manipulation';
+export * from './type-guards';

package/dist/index.js

@@ -1 +1 @@
-export{keysToCamelCase}from"./keys-to-camel-case.js";export{keysToSnakeCase}from"./keys-to-snake-case.js";
+const t=/([\p{Ll}\d])(\p{Lu})/gu,e=/(\p{Lu})([\p{Lu}][\p{Ll}])/gu,n=/(\d)\p{Ll}|(\p{L})\d/u,r=/[^\p{L}\d]+/giu,o="$1\0$2";function c(n){let c=n.trim();c=c.replace(t,o).replace(e,o),c=c.replace(r,"\0");let u=0,f=c.length;for(;"\0"===c.charAt(u);)u++;if(u===f)return[];for(;"\0"===c.charAt(f-1);)f--;return c.slice(u,f).split(/\0/g)}function u(t){const e=c(t);for(let t=0;t<e.length;t++){const r=e[t],o=n.exec(r);if(o){const n=o.index+(o[1]??o[2]).length;e.splice(t,1,r.slice(0,n),r.slice(n))}}return e}function f(t){return!1===t?t=>t.toLowerCase():e=>e.toLocaleLowerCase(t)}function i(t,e={}){const n=e.split??(e.separateNumbers?u:c),r=e.prefixCharacters??"",o=e.suffixCharacters??"";let f=0,i=t.length;for(;f<t.length;){const e=t.charAt(f);if(!r.includes(e))break;f++}for(;i>f;){const e=i-1,n=t.charAt(e);if(!o.includes(n))break;i=e}return[t.slice(0,f),n(t.slice(f,i)),t.slice(i)]}function s(t){return function(t,e){const[n,r,o]=i(t,e),c=f(e?.locale),u=function(t){return e=>e.toLocaleUpperCase(t)}(e?.locale),s=function(t,e){return(n,r)=>{const o=n[0];return(r>0&&o>="0"&&o<="9"?"_"+o:e(o))+t(n.slice(1))}}(c,u);return n+r.map((t,e)=>0===e?c(t):s(t,e)).join("")+o}(t)}function l(t){return function(t,e){const[n,r,o]=i(t,e);return n+r.map(f(e?.locale)).join(e?.delimiter??" ")+o}(t,{delimiter:"_"})}function a(t){if(Array.isArray(t))return t.map(a);if(null===t||"object"!=typeof t)return t;const e={};for(const[n,r]of Object.entries(t)){e[s(n)]=a(r)}return e}function p(t){if(Array.isArray(t))return t.map(p);if(null===t||"object"!=typeof t)return t;const e={};for(const[n,r]of Object.entries(t)){e[l(n)]=p(r)}return e}function y(t){return t&&t.__esModule&&Object.prototype.hasOwnProperty.call(t,"default")?t.default:t}var g,b={exports:{}};var j=(g||(g=1,function(t){const e=Object.getPrototypeOf({});function n(){return function(t){return!("object"!=typeof t||null===t||t instanceof RegExp||t instanceof Date)}}function r(t){function r(t){return"constructor"!==t&&"prototype"!==t&&"__proto__"!==t}const o=Object.prototype.propertyIsEnumerable,c=t?.symbols?function(t){const e=Object.keys(t),n=Object.getOwnPropertySymbols(t);for(let r=0,c=n.length;r<c;++r)o.call(t,n[r])&&e.push(n[r]);return e}:Object.keys,u="function"==typeof t?.cloneProtoObject?t.cloneProtoObject:void 0,f="function"==typeof t?.isMergeableObject?t.isMergeableObject:n(),i=t&&"function"==typeof t.mergeArray?t.mergeArray({clone:s,deepmerge:l,getKeys:c,isMergeableObject:f}):function(t,e){const n=t.length,r=e.length;let o=0;const c=new Array(n+r);for(;o<n;++o)c[o]=s(t[o]);for(o=0;o<r;++o)c[o+n]=s(e[o]);return c};function s(t){return f(t)?Array.isArray(t)?function(t){let e=0;const n=t.length,r=new Array(n);for(;e<n;++e)r[e]=s(t[e]);return r}(t):function(t){const n={};if(u&&Object.getPrototypeOf(t)!==e)return u(t);const o=c(t);let f,i,l;for(f=0,i=o.length;f<i;++f)r(l=o[f])&&(n[l]=s(t[l]));return n}(t):t}function l(t,n){const o=Array.isArray(n),a=Array.isArray(t);return"object"!=typeof(p=n)||null===p?n:f(t)?o&&a?i(t,n):o!==a?s(n):function(t,n){const o={},i=c(t),a=c(n);let p,y,g;for(p=0,y=i.length;p<y;++p)r(g=i[p])&&-1===a.indexOf(g)&&(o[g]=s(t[g]));for(p=0,y=a.length;p<y;++p)r(g=a[p])&&(g in t?-1!==i.indexOf(g)&&(u&&f(n[g])&&Object.getPrototypeOf(n[g])!==e?o[g]=u(n[g]):o[g]=l(t[g],n[g])):o[g]=s(n[g]));return o}(t,n):s(n);var p}return t?.all?function(){switch(arguments.length){case 0:return{};case 1:return s(arguments[0]);case 2:return l(arguments[0],arguments[1])}let t;for(let e=0,n=arguments.length;e<n;++e)t=l(t,arguments[e]);return t}:l}t.exports=r,t.exports.default=r,t.exports.deepmerge=r,Object.defineProperty(t.exports,"isMergeableObject",{get:n})}(b)),b.exports);function O(t){return"object"==typeof t&&null!==t&&!Array.isArray(t)}function h(t){if(!O(t))return!1;const e=Object.getPrototypeOf(t);return null===e||e===Object.prototype}function A(t){return O(t)&&0===Object.keys(t).length}const d=y(j)();function m(t,e){const n={};for(const r of e)r in t&&(n[r]=t[r]);return n}function x(t,e){const n={...t};for(const t of e)delete n[t];return n}function L(t,e){return d(t,e)}function w(...t){if(0===t.length)return{};if(1===t.length)return t[0]??{};let e={};for(const n of t)e=d(e,n);return e}function P(t,e,n){const r=e.split(".");let o=t;for(const t of r){if(null==o||"object"!=typeof o||!(t in o))return n;o=o[t]}return o}function _(t,e,n){const r=e.split("."),o=r.pop();if(null==o||0===o.length)return t;let c=t;for(const t of r)t in c&&O(c[t])||(c[t]={}),c=c[t];return c[o]=n,t}function k(t,e){const n=e.split(".");let r=t;for(const t of n){if(null==r||"object"!=typeof r||!(t in r))return!1;r=r[t]}return!0}function v(t,e=""){const n=[];for(const[r,o]of Object.entries(t)){const t=e?`${e}.${r}`:r;O(o)?n.push(...v(o,t)):n.push(t)}return n}function C(t){if(null===t||"object"!=typeof t)return t;if(t instanceof Date)return new Date(t.getTime());if(t instanceof RegExp)return new RegExp(t.source,t.flags);if(Array.isArray(t))return t.map(t=>C(t));const e={};for(const[n,r]of Object.entries(t))e[n]=C(r);return e}function D(t,e){if(t===e)return!0;if(typeof t!=typeof e)return!1;if(null===t||null===e)return!1;if(t instanceof Date&&e instanceof Date)return t.getTime()===e.getTime();if(Array.isArray(t)&&Array.isArray(e))return t.length===e.length&&t.every((t,n)=>D(t,e[n]));if("object"==typeof t&&"object"==typeof e){const n=Object.keys(t),r=Object.keys(e);return n.length===r.length&&n.every(n=>D(t[n],e[n]))}return!1}function M(t,e){const n={};for(const[r,o]of Object.entries(t))n[r]=e(o,r);return n}function E(t,e){const n={};for(const[r,o]of Object.entries(t)){n[e(r)]=o}return n}export{C as deepClone,D as deepEqual,d as deepmerge,v as flatKeys,P as get,k as has,A as isEmptyObject,O as isObject,h as isPlainObject,a as keysToCamelCase,p as keysToSnakeCase,E as mapKeys,M as mapValues,L as merge,w as mergeAll,x as omit,m as pick,_ as set};

package/dist/manipulation.d.ts

@@ -0,0 +1,195 @@
+declare const deepMerge: import("@fastify/deepmerge").DeepMergeFn;
+/**
+ * Pick specific keys from an object.
+ *
+ * @param obj - The source object
+ * @param keys - The keys to pick
+ * @returns A new object with only the specified keys
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: 2, c: 3 };
+ * pick(obj, ['a', 'c']); // { a: 1, c: 3 }
+ * ```
+ */
+export declare function pick<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: readonly K[]): Pick<T, K>;
+/**
+ * Omit specific keys from an object.
+ *
+ * @param obj - The source object
+ * @param keys - The keys to omit
+ * @returns A new object without the specified keys
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: 2, c: 3 };
+ * omit(obj, ['b']); // { a: 1, c: 3 }
+ * ```
+ */
+export declare function omit<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: readonly K[]): Omit<T, K>;
+/**
+ * Deep merge two objects.
+ *
+ * Uses @fastify/deepmerge for efficient and reliable deep merging.
+ *
+ * @param target - The target object
+ * @param source - The source object to merge into the target
+ * @returns A new merged object
+ *
+ * @example
+ * ```typescript
+ * const obj1 = { a: 1, b: { c: 2 } };
+ * const obj2 = { b: { d: 3 }, e: 4 };
+ * merge(obj1, obj2); // { a: 1, b: { c: 2, d: 3 }, e: 4 }
+ * ```
+ */
+export declare function merge<T extends Record<string, unknown>, U extends Record<string, unknown>>(target: T, source: U): T & U;
+/**
+ * Deep merge multiple objects.
+ *
+ * Uses @fastify/deepmerge to merge any number of objects into a single result.
+ * Objects are merged from left to right, with later objects overriding earlier ones.
+ *
+ * @param objects - The objects to merge
+ * @returns A new merged object
+ *
+ * @example
+ * ```typescript
+ * const obj1 = { a: 1, b: { c: 2 } };
+ * const obj2 = { b: { d: 3 }, e: 4 };
+ * const obj3 = { e: 5, f: 6 };
+ * mergeAll(obj1, obj2, obj3); // { a: 1, b: { c: 2, d: 3 }, e: 5, f: 6 }
+ * ```
+ */
+export declare function mergeAll<T extends Record<string, unknown>>(...objects: T[]): Record<string, unknown>;
+/**
+ * Re-export the configured deepmerge instance from @fastify/deepmerge.
+ *
+ * This provides direct access to the deepmerge function for advanced use cases,
+ * allowing merging of multiple objects and custom options.
+ *
+ * @example
+ * ```typescript
+ * import { deepmerge } from '@pixpilot/object';
+ * const result = deepmerge({ a: 1 }, { b: 2 }, { c: 3 });
+ * // { a: 1, b: 2, c: 3 }
+ * ```
+ */
+export { deepMerge as deepmerge };
+/**
+ * Get a nested value from an object using a path string.
+ *
+ * @param obj - The source object
+ * @param path - The path to the value (e.g., 'a.b.c')
+ * @param defaultValue - The default value to return if the path doesn't exist
+ * @returns The value at the path or the default value
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: { b: { c: 42 } } };
+ * get(obj, 'a.b.c'); // 42
+ * get(obj, 'a.b.x', 'default'); // 'default'
+ * ```
+ */
+export declare function get<T = unknown>(obj: Record<string, unknown>, path: string, defaultValue?: T): T | undefined;
+/**
+ * Set a nested value in an object using a path string.
+ *
+ * @param obj - The target object
+ * @param path - The path to set the value at (e.g., 'a.b.c')
+ * @param value - The value to set
+ * @returns The modified object
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: { b: {} } };
+ * set(obj, 'a.b.c', 42); // { a: { b: { c: 42 } } }
+ * ```
+ */
+export declare function set<T extends Record<string, unknown>>(obj: T, path: string, value: unknown): T;
+/**
+ * Check if an object has a nested property using a path string.
+ *
+ * @param obj - The source object
+ * @param path - The path to check (e.g., 'a.b.c')
+ * @returns True if the path exists, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: { b: { c: 42 } } };
+ * has(obj, 'a.b.c'); // true
+ * has(obj, 'a.b.x'); // false
+ * ```
+ */
+export declare function has(obj: Record<string, unknown>, path: string): boolean;
+/**
+ * Get all keys of an object including nested keys.
+ *
+ * @param obj - The source object
+ * @param prefix - The prefix to prepend to keys (used internally for recursion)
+ * @returns An array of all keys including nested paths
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: { c: 2, d: { e: 3 } } };
+ * flatKeys(obj); // ['a', 'b.c', 'b.d.e']
+ * ```
+ */
+export declare function flatKeys(obj: Record<string, unknown>, prefix?: string): string[];
+/**
+ * Deep clone an object.
+ *
+ * @param obj - The object to clone
+ * @returns A deep clone of the object
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: { c: 2 } };
+ * const cloned = deepClone(obj);
+ * cloned.b.c = 3;
+ * console.log(obj.b.c); // 2 (original unchanged)
+ * ```
+ */
+export declare function deepClone<T>(obj: T): T;
+/**
+ * Compare two objects for deep equality.
+ *
+ * @param obj1 - The first object
+ * @param obj2 - The second object
+ * @returns True if the objects are deeply equal, false otherwise
+ *
+ * @example
+ * ```typescript
+ * deepEqual({ a: 1, b: { c: 2 } }, { a: 1, b: { c: 2 } }); // true
+ * deepEqual({ a: 1 }, { a: 2 }); // false
+ * ```
+ */
+export declare function deepEqual(obj1: unknown, obj2: unknown): boolean;
+/**
+ * Map over the values of an object.
+ *
+ * @param obj - The source object
+ * @param fn - The mapping function
+ * @returns A new object with mapped values
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: 2, c: 3 };
+ * mapValues(obj, (value) => value * 2); // { a: 2, b: 4, c: 6 }
+ * ```
+ */
+export declare function mapValues<T extends Record<string, unknown>, U>(obj: T, fn: (value: T[keyof T], key: keyof T) => U): Record<keyof T, U>;
+/**
+ * Map over the keys of an object.
+ *
+ * @param obj - The source object
+ * @param fn - The mapping function
+ * @returns A new object with mapped keys
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: 2 };
+ * mapKeys(obj, (key) => key.toUpperCase()); // { A: 1, B: 2 }
+ * ```
+ */
+export declare function mapKeys<T extends Record<string, unknown>>(obj: T, fn: (key: keyof T) => string): Record<string, T[keyof T]>;

package/dist/type-guards.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Type guard to check if a value is an object (and not null or an array).
+ *
+ * @param value - The value to check
+ * @returns True if the value is an object, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isObject({}); // true
+ * isObject({ key: 'value' }); // true
+ * isObject([]); // false
+ * isObject(null); // false
+ * isObject('string'); // false
+ * ```
+ */
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Type guard to check if a value is a plain object
+ * (created with {} or new Object(), not a class instance).
+ *
+ * @param value - The value to check
+ * @returns True if the value is a plain object, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isPlainObject({}); // true
+ * isPlainObject({ key: 'value' }); // true
+ * isPlainObject(new Date()); // false
+ * isPlainObject([]); // false
+ * ```
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Type guard to check if a value is an empty object.
+ *
+ * @param value - The value to check
+ * @returns True if the value is an empty object, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isEmptyObject({}); // true
+ * isEmptyObject({ key: 'value' }); // false
+ * isEmptyObject([]); // false
+ * ```
+ */
+export declare function isEmptyObject(value: unknown): boolean;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pixpilot/object",
   "type": "module",
-  "version": "1.0.2",
+  "version": "1.1.5",
   "author": "Pixpilot <m.doaie@hotmail.com>",
   "license": "MIT",
   "repository": {
@@ -24,18 +24,22 @@
     "access": "public"
   },
   "dependencies": {
-    "@pixpilot/string": "1.0.0"
+    "@fastify/deepmerge": "^3.1.0",
+    "@pixpilot/string": "2.0.5"
   },
   "devDependencies": {
+    "@manypkg/get-packages": "^3.1.0",
+    "@rollup/plugin-alias": "^5.1.1",
+    "@rollup/plugin-node-resolve": "^16.0.3",
     "@types/node": "^22.18.10",
     "eslint": "^9.37.0",
     "rollup": "^4.52.4",
     "typescript": "^5.9.3",
+    "@internal/eslint-config": "0.3.0",
     "@internal/prettier-config": "0.0.1",
     "@internal/rollup-config": "0.1.0",
-    "@internal/eslint-config": "0.3.0",
-    "@internal/vitest-config": "0.1.0",
-    "@internal/tsconfig": "0.1.0"
+    "@internal/tsconfig": "0.1.0",
+    "@internal/vitest-config": "0.1.0"
   },
   "prettier": "@internal/prettier-config",
   "scripts": {

package/dist/keys-to-camel-case.cjs

@@ -1 +0,0 @@
-"use strict";var r=require("@pixpilot/string");exports.keysToCamelCase=function e(t){if(Array.isArray(t))return t.map(e);if(null===t||"object"!=typeof t)return t;const o={};for(const[s,i]of Object.entries(t)){o[r.toCamelCase(s)]=e(i)}return o};

package/dist/keys-to-camel-case.js

@@ -1 +0,0 @@
-import{toCamelCase as r}from"@pixpilot/string";function t(o){if(Array.isArray(o))return o.map(t);if(null===o||"object"!=typeof o)return o;const n={};for(const[e,i]of Object.entries(o)){n[r(e)]=t(i)}return n}export{t as keysToCamelCase};

package/dist/keys-to-snake-case.cjs

@@ -1 +0,0 @@
-"use strict";var r=require("@pixpilot/string");exports.keysToSnakeCase=function e(t){if(Array.isArray(t))return t.map(e);if(null===t||"object"!=typeof t)return t;const n={};for(const[o,s]of Object.entries(t)){n[r.toSnakeCase(o)]=e(s)}return n};

package/dist/keys-to-snake-case.js

@@ -1 +0,0 @@
-import{toSnakeCase as r}from"@pixpilot/string";function t(o){if(Array.isArray(o))return o.map(t);if(null===o||"object"!=typeof o)return o;const n={};for(const[e,i]of Object.entries(o)){n[r(e)]=t(i)}return n}export{t as keysToSnakeCase};