feat: add transformKeysToSnake

CHANGELOG

@@ -1,3 +1,6 @@
+#1.20.0
+- feat: add transformKeysToSnake
+
 #1.19.1
 - fix: fix isPlainObject to check that the constructor is an object
 

README.md

@@ -44,6 +44,7 @@ Currently supported utils:
 - `snakeCase` - convert camel case and string/dash separated strings to snake case
 - `sum` - calculate sum of array items
 - `sumBy` - calculate sum of array items using iteratee function or string shortcut
+- `transformKeysToSnake` - transform every object key to snake case
 - `union` - Returns the union of the given arrays
 - `uniqBy` - get unique values of array by the iteratee function or property path
 - `uniqWith` - Returns a new array with unique values, using a comparator function

index.d.ts

@@ -40,6 +40,7 @@ export function shuffle<T> (array: Array<T>): Array<T>
 export function snakeCase (str: string): string
 export function sum (values: Array<string>): number
 export function sumBy (values: Array, iteratee: Function | string): number
+export function transformKeysToSnake (obj: Object) : Object
 export function union (...arrays: Array[]): Array
 export function uniqBy (array: Array, iteratee: Function | string): Array
 export function uniqWith (array: Array, comparator: Function): Array

index.js

@@ -42,6 +42,7 @@ const shuffle = require('./src/shuffle')
 const snakeCase = require('./src/snakeCase')
 const sum = require('./src/sum')
 const sumBy = require('./src/sumBy')
+const transformKeysToSnake = require('./src/transformKeysToSnake')
 const union = require('./src/union')
 const uniqBy = require('./src/uniqBy')
 const uniqWith = require('./src/uniqWith')
@@ -93,6 +94,7 @@ module.exports = {
   snakeCase,
   sum,
   sumBy,
+  transformKeysToSnake,
   union,
   uniqBy,
   uniqWith,

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitfinexcom/lib-js-util-base",
-  "version": "1.19.1",
+  "version": "1.20.0",
   "description": "general utils",
   "main": "index.js",
   "scripts": {

src/transformKeysToSnake.js

@@ -0,0 +1,29 @@
+'use strict'
+
+const isPlainObject = require('./isPlainObject')
+const snakeCase = require('./snakeCase')
+
+/**
+ * Transform object keys to snake case
+ * e.g. { fooBar: 1 } => { foo_bar: 1 }
+ * @param {Object} obj
+ * @returns {Object}
+ */
+const transformKeysToSnakeCase = (obj) => {
+  if (Array.isArray(obj)) {
+    return obj.map(item => transformKeysToSnakeCase(item))
+  }
+
+  if (!isPlainObject(obj)) {
+    return obj
+  }
+
+  return Object.fromEntries(
+    Object.entries(obj).map(([k, v]) => [
+      snakeCase(k),
+      transformKeysToSnakeCase(v)
+    ])
+  )
+}
+
+module.exports = transformKeysToSnakeCase

test/transformKeystoSnake.js

@@ -0,0 +1,51 @@
+'use strict'
+
+/* eslint-env mocha */
+
+const assert = require('assert')
+const { transformKeysToSnake } = require('../index')
+const { itEach } = require('mocha-it-each')
+
+describe('transformKeysToSnake', () => {
+  itEach('should return input when it is not an object', [new Date(), null, false], (input) => {
+    assert.equal(transformKeysToSnake(input), input)
+  })
+
+  it('should return input with snake case props recursively', () => {
+    const input = {
+      camelProp: 'true',
+      nestedProp: {
+        first_name: 'john',
+        lastName: 'doe',
+        tags: ['keepCamel']
+      },
+      someObjs: [
+        { someProp: 'value' },
+        { foo_bar: 'value', foo: 'value' }
+      ]
+    }
+    const output = {
+      camel_prop: 'true',
+      nested_prop: {
+        first_name: 'john',
+        last_name: 'doe',
+        tags: ['keepCamel']
+      },
+      some_objs: [
+        { some_prop: 'value' },
+        { foo_bar: 'value', foo: 'value' }
+      ]
+    }
+    assert.deepEqual(transformKeysToSnake(input), output)
+  })
+
+  it('should work with', () => {
+    const input = {
+      mixedArray: [123, { someKey: 'value' }, [{ nestedArrayItem: 'test' }]]
+    }
+    const output = {
+      mixed_array: [123, { some_key: 'value' }, [{ nested_array_item: 'test' }]]
+    }
+    assert.deepEqual(transformKeysToSnake(input), output)
+  })
+})