feat: Typecast Objects

.gitignore

@@ -1,2 +1,3 @@
 node_modules
 package-lock.json
+.vscode

index.js

@@ -83,4 +83,24 @@ typecast.array = function (val) {
 
 typecast.boolean = function (val) {
   return !! val && val !== 'false' && val !== '0';
-};
+};
+
+/**
+ * Cast `val` to `Object`
+ *
+ * @param {Mixed} val
+ * @api public
+ */
+typecast.object = function(val) {
+  if (val == null) return {};
+  if (Array.isArray(val)) return Object.assign({}, val);
+  if (val instanceof Object) return val;
+  if (typeof val !== 'string') return { value: val };
+  let obj = {};
+  try {
+	  obj = JSON.parse(val);
+  } catch (error) {
+	  obj = { value: val };
+  }
+  return obj;
+};

package.json

@@ -6,7 +6,7 @@
     "test": "mocha --reporter spec --bail"
   },
   "devDependencies": {
-    "mocha": "~1.17.0"
+    "mocha": "^8.1.1"
   },
   "repository": {
     "type": "git",

test/index.js

@@ -30,7 +30,7 @@ describe('.number()', function () {
 
 describe('.date()', function () {
   it('should return a date', function () {
-    assert(typecast.date('2010 10 01').valueOf() === 1285884000000);
+    assert(typecast.date('2010 10 01').valueOf() === 1285905600000);
   })
 
   it('should return default date if typecasting fails', function () {
@@ -81,6 +81,46 @@ describe('.boolean()', function () {
   })
 })
 
+describe('.object()', function () {
+  it('should return an object', function () {
+	  var obj = {x: 1, y: 2, z: 3};
+	  assert(typecast.object(obj) === obj);
+	  assert(typecast.object(1) instanceof Object);
+	  assert(Object.entries(typecast.object('{"x": 1, "y": 2, "z": 3}')).length == 3);
+	  assert(typecast.object('{"x": 1, "y": 2, "z": 3}').z === 3);
+  })
+
+  it('should preserve non-string objects', function () {
+	  var now = new Date();
+	  assert(typeof typecast.object(now) === 'object');
+	  assert(Object.entries(typecast.object(now)).length == 0);
+	  assert(typeof typecast.object(now).getTime === 'function');
+  });
+
+  it('should return an empty object when given a null-ish value', function () {
+	  assert(typeof typecast.object(null) == 'object');
+	  assert(Object.entries(typecast.object(null)).length == 0);
+
+	  assert(typeof typecast.object(undefined) == 'object');
+	  assert(Object.entries(typecast.object(undefined)).length == 0);
+  })
+
+  it('should return parsed JSON object when given valid JSON', function () {
+    const validJSON = '{"x": 1, "y": 2, "z": 3}'
+    assert(typeof typecast.object(validJSON) == 'object');
+    assert(Object.entries(typecast.object(validJSON)).length == 3);
+	  assert(typecast.object(validJSON).z === 3);
+  })
+
+  it('should return value as property when given non-JSON string or other primitive', function () {
+    const invalidJSON = 'x: 1, y: 2, z: 3'
+    assert(typeof typecast.object(invalidJSON) == 'object');
+    assert(Object.entries(typecast.object(invalidJSON)).length == 1);
+	  assert(typecast.object(invalidJSON).value === 'x: 1, y: 2, z: 3');
+	  assert(typecast.object(1).value === 1);
+  })
+})
+
 describe('typecast()', function () {
   it('should work', function () {
     assert(typecast(123, 'string') === '123');
@@ -95,4 +135,4 @@ describe('typecast()', function () {
     }
     assert(err);
   });
-});
+});