Add DateString type

New type that preserves string input as a string, but ensures that
the string is a valid Date.

Additionally, provides a .toDate function to provide the Date
object representation of the string.

Author: Kevin Delisle

lib/date-string.js

@@ -0,0 +1,61 @@
+// Copyright IBM Corp. 2013,2016. All Rights Reserved.
+// Node module: loopback-datasource-juggler
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+
+'use strict';
+
+var inspect = require('util').inspect;
+
+module.exports = DateString;
+
+/**
+ * A String whose value is a valid representation of a Date.
+ * Use this type if you need to preserve the format of the value and still
+ * check if it's valid.
+ * @param {String} value
+ * @constructor
+ */
+function DateString(value) {
+  if (!(this instanceof DateString)) {
+    return new DateString(value);
+  }
+
+  if (typeof(value) !== 'string') {
+    throw new Error('Input must be a string');
+  }
+
+  Object.defineProperty(this, 'value', {
+    get: () => { return this._value; },
+    set: (val) => {
+      var d = new Date(val);
+      if (isNaN(d.getTime())) {
+        throw new Error('Invalid date');
+      } else {
+        this._value = val;
+        this._date = d;
+      }
+    },
+  });
+
+  this.value = value;
+};
+
+/**
+ * Returns the value of DateString in its original form.
+ * @returns {String} The Date as a String.
+ */
+DateString.prototype.toString = function() {
+  return this.value;
+};
+
+DateString.prototype.toJSON = function() {
+  return this.value;
+};
+
+DateString.prototype.inspect = function(depth, options) {
+  return 'DateString ' + inspect({
+    value: this.value,
+    _date: this._date,
+  });
+};

lib/types.js

@@ -40,6 +40,7 @@ Types.Any.prototype.toObject = Types.Any.prototype.toJSON = function() {
 };
 
 module.exports = function(modelTypes) {
+  var DateString = require('./date-string');
   var GeoPoint = require('./geo').GeoPoint;
 
   for (var t in Types) {
@@ -63,6 +64,7 @@ module.exports = function(modelTypes) {
   modelTypes.registerType(Number);
   modelTypes.registerType(Boolean);
   modelTypes.registerType(Date);
+  modelTypes.registerType(DateString);
   modelTypes.registerType(Buffer, ['Binary']);
   modelTypes.registerType(Array);
   modelTypes.registerType(GeoPoint);

test/date-string.test.js

@@ -0,0 +1,72 @@
+// Copyright IBM Corp. 2014,2016. All Rights Reserved.
+// Node module: loopback-datasource-juggler
+// This file is licensed under the MIT License.
+// License text available at https://opensource.org/licenses/MIT
+
+/* global describe,it */
+/* jshint expr:true */
+
+'use strict';
+
+require('should');
+
+var DateString = require('../lib/date-string');
+var fmt = require('util').format;
+var inspect = require('util').inspect;
+var os = require('os');
+
+describe('DateString', function() {
+  describe('constructor', function() {
+    it('should support a valid date string', function() {
+      var theDate = '2015-01-01';
+      var date = new DateString(theDate);
+      date.should.not.eql(null);
+      date.value.should.eql(theDate);
+      date.toString().should.eql(theDate);
+    });
+
+    it('should throw on invalid input', function() {
+      var fn = () => {
+        var date = new DateString('notadate');
+      };
+      fn.should.throw(new Error('Invalid date'));
+
+      fn = () => {
+        var date = new DateString('2015-01-01 25:00:00');
+      };
+      fn.should.throw(new Error('Invalid date'));
+
+      fn = () => {
+        var date = new DateString(20150101);
+      };
+      fn.should.throw(new Error('Input must be a string'));
+    });
+
+    it('should update internal date on set', function() {
+      var date = new DateString('2015-01-01');
+      date.value = '2016-01-01';
+      date.value.should.eql('2016-01-01');
+      var d = new Date('2016-01-01');
+      // The internal date representation should also be updated!
+      date._date.toString().should.eql(d.toString());
+    });
+
+    it('should allow date with time', function() {
+      var theDate = '2015-01-01 02:00:00';
+      var date = new DateString(theDate);
+      date.value.should.eql(theDate);
+      var d = new Date(theDate);
+      date._date.toString().should.eql(d.toString());
+    });
+
+    it('should return custom inspect output', function() {
+      var date = new DateString('2015-01-01');
+      var result = inspect(date);
+      result.should.not.eql(null);
+      result.should.eql(fmt('DateString ' + inspect({
+        value: date.value,
+        _date: date._date,
+      })));
+    });
+  });
+});