avvir 0.4.17 → 0.4.19

package/dist/esm/converters/date_formatter.d.ts

@@ -0,0 +1,16 @@
+import moment from "moment";
+export declare class DateFormatter {
+    constructor(format: string, secondaryFormat?: string);
+    /** Use formatLocal when displaying times relative to the user i.e. when
+     * somebody else replied to their comment, or when a file was uploaded. */
+    formatLocal(date: Date): string;
+    /** Use formatUTC when all users should see the same information, regardless
+     * of their geographical location. i.e. dates pertaining to what happened on
+     * the job site */
+    formatUTC(date: moment.MomentInput): string;
+    formatRangeLocal(startDate: Date, endDate?: Date): string;
+    parseUTC(date: string | null): Date;
+    private readonly formatString;
+    private readonly secondaryFormat?;
+}
+export default DateFormatter;

package/dist/esm/converters/date_formatter.js

@@ -0,0 +1,48 @@
+import moment from "moment";
+export class DateFormatter {
+    constructor(format, secondaryFormat) {
+        this.formatString = format;
+        this.secondaryFormat = secondaryFormat;
+    }
+    /** Use formatLocal when displaying times relative to the user i.e. when
+     * somebody else replied to their comment, or when a file was uploaded. */
+    formatLocal(date) {
+        if (date) {
+            return moment(date).format(this.formatString);
+        }
+        else {
+            return "";
+        }
+    }
+    /** Use formatUTC when all users should see the same information, regardless
+     * of their geographical location. i.e. dates pertaining to what happened on
+     * the job site */
+    formatUTC(date) {
+        if (date) {
+            return moment(date).utc().format(this.formatString);
+        }
+        else {
+            return "";
+        }
+    }
+    formatRangeLocal(startDate, endDate) {
+        let formatted = this.formatLocal(startDate);
+        if (endDate != null) {
+            formatted += " - ";
+            let endMoment = moment(endDate);
+            if (this.secondaryFormat
+                && moment(startDate).isSame(endMoment, "day")) {
+                formatted += endMoment.format(this.secondaryFormat);
+            }
+            else {
+                formatted += this.formatLocal(endDate);
+            }
+        }
+        return formatted;
+    }
+    parseUTC(date) {
+        return moment.utc(date, this.formatString).toDate();
+    }
+}
+export default DateFormatter;
+//# sourceMappingURL=date_formatter.js.map

package/dist/esm/converters/date_formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date_formatter.js","sourceRoot":"","sources":["../../../source/converters/date_formatter.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,OAAO,aAAa;IACxB,YAAY,MAAc,EAAE,eAAwB;QAClD,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED;8EAC0E;IAC1E,WAAW,CAAC,IAAU;QACpB,IAAI,IAAI,EAAE;YACR,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;SAC/C;aAAM;YACL,OAAO,EAAE,CAAC;SACX;IACH,CAAC;IAED;;sBAEkB;IAClB,SAAS,CAAC,IAAwB;QAChC,IAAI,IAAI,EAAE;YACR,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;SACrD;aAAM;YACL,OAAO,EAAE,CAAC;SACX;IACH,CAAC;IAED,gBAAgB,CAAC,SAAe,EAAE,OAAc;QAC9C,IAAI,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,OAAO,IAAI,IAAI,EAAE;YACnB,SAAS,IAAI,KAAK,CAAC;YACnB,IAAI,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,IAAI,CAAC,eAAe;mBACjB,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,EACjD;gBACE,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;aACrD;iBAAM;gBACL,SAAS,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;aACxC;SACF;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,CAAC,IAAmB;QAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC;IACtD,CAAC;CAIF;AAED,eAAe,aAAa,CAAC"}

package/dist/esm/converters/index.d.ts

@@ -1,4 +1,5 @@
-export { DateConverter, DateFormatter } from "./date_converter";
+export { DateConverter } from "./date_converter";
+export { DateFormatter } from "./date_formatter";
 export { kebabCase } from "./kebab_case";
 export { Matrix3Converter } from "./matrix_3_converter";
 export { Matrix4Converter } from "./matrix_4_converter";

package/dist/esm/converters/index.js

@@ -1,4 +1,5 @@
-export { DateConverter, DateFormatter } from "./date_converter";
+export { DateConverter } from "./date_converter";
+export { DateFormatter } from "./date_formatter";
 export { kebabCase } from "./kebab_case";
 export { Matrix3Converter } from "./matrix_3_converter";
 export { Matrix4Converter } from "./matrix_4_converter";

package/dist/esm/converters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/converters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAC,oBAAoB,EAAC,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/converters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/esm/mixins/add_instant_getter_and_setter_to_api_model.js

@@ -8,11 +8,20 @@ export function addInstantGetterAndSetterToApiModel(modelInstance, propertyName,
         },
         set(val) {
             if (typeof val === "string") {
-                dateVal = DateConverter.dateToInstant(moment(val, "MMM D, YYYY").utc(true));
+                const date = moment(val, "MMM D, YYYY").utc(true).toDate();
+                if (DateConverter.isValidDate(date)) {
+                    dateVal = DateConverter.dateToInstant(date);
+                }
+                else {
+                    dateVal = null;
+                }
             }
-            else if (val instanceof Date || moment.isMoment(val)) {
+            else if (val instanceof Date) {
                 dateVal = DateConverter.dateToInstant(val);
             }
+            else if (moment.isMoment(val)) {
+                dateVal = DateConverter.dateToInstant(val.toDate());
+            }
             else {
                 dateVal = val;
             }

package/dist/esm/mixins/add_instant_getter_and_setter_to_api_model.js.map

@@ -1 +1 @@
-{"version":3,"file":"add_instant_getter_and_setter_to_api_model.js","sourceRoot":"","sources":["../../../source/mixins/add_instant_getter_and_setter_to_api_model.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,aAAa,MAAM,8BAA8B,CAAC;AAGzD,MAAM,UAAU,mCAAmC,CAAC,aAAqB,EAAE,YAAoB,EAAE,YAAuB;IACtH,IAAI,OAAO,CAAC;IACZ,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,YAAY,EAAE;QACjD,GAAG;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,GAAG,CAAC,GAAG;YACL,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;gBAC3B,OAAO,GAAG,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;aAC7E;iBAAM,IAAI,GAAG,YAAY,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;gBACtD,OAAO,GAAG,aAAa,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;aAC5C;iBAAM;gBACL,OAAO,GAAG,GAAG,CAAC;aACf;QACH,CAAC;QACD,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IAEH,IAAI,YAAY,EAAE;QAChB,aAAa,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;KAC5C;AACH,CAAC;AAED,eAAe,mCAAmC,CAAC"}
+{"version":3,"file":"add_instant_getter_and_setter_to_api_model.js","sourceRoot":"","sources":["../../../source/mixins/add_instant_getter_and_setter_to_api_model.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,aAAa,MAAM,8BAA8B,CAAC;AAGzD,MAAM,UAAU,mCAAmC,CAAC,aAAqB,EACrB,YAAoB,EACpB,YAAuB;IAEzE,IAAI,OAAO,CAAC;IACZ,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,YAAY,EAAE;QACjD,GAAG;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,GAAG,CAAC,GAAG;YACL,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;gBAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;gBAC3D,IAAI,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE;oBACnC,OAAO,GAAG,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;iBAC7C;qBAAM;oBACL,OAAO,GAAG,IAAI,CAAC;iBAChB;aACF;iBAAM,IAAI,GAAG,YAAY,IAAI,EAAE;gBAC9B,OAAO,GAAG,aAAa,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;aAC5C;iBAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;gBAC/B,OAAO,GAAG,aAAa,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;aACrD;iBAAM;gBACL,OAAO,GAAG,GAAG,CAAC;aACf;QACH,CAAC;QACD,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IAEH,IAAI,YAAY,EAAE;QAChB,aAAa,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;KAC5C;AACH,CAAC;AAED,eAAe,mCAAmC,CAAC"}

package/dist/esm/utilities/make_errors_pretty.d.ts

@@ -1,5 +1,9 @@
-declare const makeErrorsPretty: (apiClass: any, options?: {
-    exclude: any[];
-    overrideErrorMessage: any[];
-}) => any;
+declare type MethodProperties<T> = keyof {
+    [P in keyof T as T[P] extends (...args: any) => any ? P : never]: any;
+};
+declare type Options<Class> = {
+    exclude?: MethodProperties<Class>[];
+    overrideErrorMessage?: MethodProperties<Class>[];
+};
+declare const makeErrorsPretty: <Class>(apiClass: Class, options?: Options<Class>) => Class;
 export default makeErrorsPretty;

package/dist/esm/utilities/make_errors_pretty.js

@@ -2,7 +2,7 @@ import _ from "underscore";
 import checkFetchStatus from "./check_fetch_status";
 import Config from "../config";
 const makeErrorsPrettyForFunction = (actionName, action, displayErrorMessage) => {
-    return (...argumentList) => {
+    return ((...argumentList) => {
         return action(...argumentList)
             .then((response) => checkFetchStatus(response, displayErrorMessage))
             .catch((error) => {
@@ -12,7 +12,7 @@ const makeErrorsPrettyForFunction = (actionName, action, displayErrorMessage) =>
                 arguments: argumentList
             });
         });
-    };
+    });
 };
 const getFunctionNames = (clazz) => {
     let builtinProperties = ["length", "constructor", "name", "prototype"];
@@ -25,6 +25,7 @@ const makeErrorsPretty = (apiClass, options = { exclude: [], overrideErrorMessag
         let isExcluded = options.exclude && options.exclude.includes(functionName);
         let displayErrorMessage = !options.overrideErrorMessage || !options.overrideErrorMessage.includes(functionName);
         if (!isExcluded) {
+            // @ts-ignore
             apiClass[functionName] = makeErrorsPrettyForFunction(functionName, apiClass[functionName], displayErrorMessage);
         }
     });

package/dist/esm/utilities/make_errors_pretty.js.map

@@ -1 +1 @@
-{"version":3,"file":"make_errors_pretty.js","sourceRoot":"","sources":["../../../source/utilities/make_errors_pretty.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,YAAY,CAAC;AAC3B,OAAO,gBAAgB,MAAM,sBAAsB,CAAC;AACpD,OAAO,MAAM,MAAM,WAAW,CAAC;AAE/B,MAAM,2BAA2B,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE;IAC9E,OAAO,CAAC,GAAG,YAAY,EAAE,EAAE;QACzB,OAAO,MAAM,CAAC,GAAG,YAAY,CAAC;aAC3B,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;aACnE,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,OAAO,MAAM,CAAC,kBAAkB,CAAC;gBAC/B,KAAK;gBACL,MAAM,EAAE,UAAU;gBAClB,SAAS,EAAE,YAAY;aACxB,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IAEN,CAAC,CAAA;AACH,CAAC,CAAA;AACD,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,EAAE;IACjC,IAAI,iBAAiB,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACvE,8DAA8D;IAC9D,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,GAAG,iBAAiB,CAAC,CAAA;AAC3E,CAAC,CAAA;AAED,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,OAAO,GAAG,EAAC,OAAO,EAAE,EAAE,EAAE,oBAAoB,EAAE,EAAE,EAAC,EAAE,EAAE;IACvF,IAAI,aAAa,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,YAAY,EAAE,EAAE;QACxC,IAAI,UAAU,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC3E,IAAI,mBAAmB,GAAG,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAChH,IAAI,CAAC,UAAU,EAAE;YACf,QAAQ,CAAC,YAAY,CAAC,GAAG,2BAA2B,CAAC,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC,CAAC;SACjH;IACH,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAA;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"make_errors_pretty.js","sourceRoot":"","sources":["../../../source/utilities/make_errors_pretty.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,YAAY,CAAC;AAC3B,OAAO,gBAAgB,MAAM,sBAAsB,CAAC;AACpD,OAAO,MAAM,MAAM,WAAW,CAAC;AAG/B,MAAM,2BAA2B,GAAG,CAAoE,UAAe,EAAE,MAAkB,EAAE,mBAA4B,EAAc,EAAE;IACvL,OAAO,CAAC,CAAC,GAAG,YAAY,EAAE,EAAE;QAC1B,OAAO,MAAM,CAAC,GAAG,YAAY,CAAC;aAC3B,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;aACnE,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,OAAO,MAAM,CAAC,kBAAkB,CAAC;gBAC/B,KAAK;gBACL,MAAM,EAAE,UAAU;gBAClB,SAAS,EAAE,YAAY;aACxB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC,CAAe,CAAC;AACnB,CAAC,CAAC;AAGF,MAAM,gBAAgB,GAAG,CAAQ,KAAY,EAA6B,EAAE;IAC1E,IAAI,iBAAiB,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACvE,8DAA8D;IAC9D,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,GAAG,iBAAiB,CAA8B,CAAC;AACzG,CAAC,CAAC;AAOF,MAAM,gBAAgB,GAAG,CAAQ,QAAe,EAAE,UAA0B,EAAE,OAAO,EAAE,EAAE,EAAE,oBAAoB,EAAE,EAAE,EAAE,EAAE,EAAE;IACvH,IAAI,aAAa,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,YAAY,EAAE,EAAE;QACxC,IAAI,UAAU,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC3E,IAAI,mBAAmB,GAAG,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAChH,IAAI,CAAC,UAAU,EAAE;YACf,aAAa;YACb,QAAQ,CAAC,YAAY,CAAC,GAAG,2BAA2B,CAAC,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC,CAAC;SACjH;IACH,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "avvir",
   "repository": "git@github.com:Avvir/avvir-javascript-client.git",
-  "version": "0.4.17",
+  "version": "0.4.19",
   "description": "Javascript client for Avvir APIs",
   "license": "Apache-2.0",
   "module": "dist/esm/index.js",

package/source/api/project_api.ts

@@ -116,4 +116,4 @@ export default class ProjectApi {
   }
 }
 
-makeErrorsPretty(ProjectApi);
+makeErrorsPretty(ProjectApi, { exclude: ["getProjectDeviationsReportTsvUrl"] });

package/source/api/scan_dataset_api.ts

@@ -1,42 +1,41 @@
-import {User} from "../utilities/get_authorization_headers";
-import {AssociationIds, DateLike} from "../models";
+import { User } from "../utilities/get_authorization_headers";
+import { ApiBuiltStatus, ApiDetailedElement, ApiPhotoSession, ApiScanDataset, ApiScannedElementType, AssociationIds, DateLike } from "../models";
 import Http from "../utilities/http";
 import makeErrorsPretty from "../utilities/make_errors_pretty";
-import ApiProgressScanDataset from "../models/api/api_progress_scan_dataset";
-import ApiView, {ViewParameter} from "../models/api/api_view";
-import {DateConverter} from "../converters";
-import {ApiScanDataset, ApiDetailedElement, ApiPhotoSession, ApiBuiltStatus, ApiScannedElementType} from "../models";
+import ApiView, { ViewParameter } from "../models/api/api_view";
+import { DateConverter } from "../converters";
 
 export default class ScanDatasetApi {
-  static listScanDatasetsForFloor({projectId, floorId}: AssociationIds, user: User): Promise<ApiScanDataset[]> {
+  static listScanDatasetsForFloor({ projectId, floorId }: AssociationIds, user: User): Promise<ApiScanDataset[]> {
     let url = `${Http.baseUrl()}/projects/${projectId}/floors/${floorId}/scan-datasets`;
     return Http.get(url, user) as unknown as Promise<ApiScanDataset[]>;
   }
 
   static mergeScanDataset({
-                             projectId,
-                             floorId,
-                             scanDatasetId
-                           }: AssociationIds, scanDataset: ApiScanDataset, user: User): Promise<void> {
+                            projectId,
+                            floorId,
+                            scanDatasetId
+                          }: AssociationIds, scanDataset: ApiScanDataset, user: User): Promise<void> {
     const url = `${Http.baseUrl()}/projects/${projectId}/floors/${floorId}/scan-datasets/${scanDatasetId}`;
     return Http.patch(url, user, scanDataset) as unknown as Promise<void>;
   }
+
   //@Deprecated
   static updateScanDataset({
-                            projectId,
-                            floorId,
-                            scanDatasetId
-                          }: AssociationIds, scanDataset: ApiScanDataset, user: User): Promise<void> {
-    return this.mergeScanDataset({projectId, floorId, scanDatasetId}, scanDataset, user);
+                             projectId,
+                             floorId,
+                             scanDatasetId
+                           }: AssociationIds, scanDataset: ApiScanDataset, user: User): Promise<void> {
+    return this.mergeScanDataset({ projectId, floorId, scanDatasetId }, scanDataset, user);
   }
 
   static replaceScanDataset({
-      projectId,
-      floorId,
-      scanDatasetId
+                              projectId,
+                              floorId,
+                              scanDatasetId
                             }: AssociationIds, scanDataset: ApiScanDataset, user: User): Promise<void> {
-      const url = `${Http.baseUrl()}/projects/${projectId}/floors/${floorId}/scan-datasets/${scanDatasetId}`;
-      return Http.put(url, user, scanDataset) as unknown as Promise<void>;
+    const url = `${Http.baseUrl()}/projects/${projectId}/floors/${floorId}/scan-datasets/${scanDatasetId}`;
+    return Http.put(url, user, scanDataset) as unknown as Promise<void>;
   }
 
   static createScanDataset({
@@ -46,12 +45,12 @@ export default class ScanDatasetApi {
                            }: AssociationIds & { scanDate?: DateLike }, user: User): Promise<ApiScanDataset> {
     let url = `${Http.baseUrl()}/projects/${projectId}/floors/${floorId}/scan-datasets`;
     if (scanDate) {
-      url += `?scanDate=${DateConverter.dateToISO(scanDate)}`
+      url += `?scanDate=${DateConverter.dateToISO(scanDate)}`;
     }
     return Http.post(url, user, null) as unknown as Promise<ApiScanDataset>;
   }
 
-  static deleteScanDataset({projectId, floorId, scanDatasetId}: AssociationIds, user: User): Promise<void> {
+  static deleteScanDataset({ projectId, floorId, scanDatasetId }: AssociationIds, user: User): Promise<void> {
     let url = `${Http.baseUrl()}/projects/${projectId}/floors/${floorId}/scan-datasets/${scanDatasetId}`;
     return Http.delete(url, user) as unknown as Promise<void>;
   };
@@ -60,12 +59,14 @@ export default class ScanDatasetApi {
                             projectId,
                             floorId,
                             scanDatasetId
-                          }: AssociationIds, analysis: ApiScannedElementType<ApiBuiltStatus>[], user: User): Promise<void> {
+                          }: AssociationIds,
+                          analysis: ApiScannedElementType<ApiBuiltStatus>[],
+                          user: User): Promise<void> {
     const url = `${Http.baseUrl()}/projects/${projectId}/floors/${floorId}/scan-datasets/${scanDatasetId}/analysis?enforceBuiltPersistence=false`;
     return Http.post(url, user, analysis) as unknown as Promise<void>;
   }
 
-  static getScanDataset({projectId, floorId, scanDatasetId}: AssociationIds, user: User): Promise<ApiScanDataset> {
+  static getScanDataset({ projectId, floorId, scanDatasetId }: AssociationIds, user: User): Promise<ApiScanDataset> {
     let url = `${Http.baseUrl()}/projects/${projectId}/floors/${floorId}/scan-datasets/${scanDatasetId}`;
     return Http.get(url, user) as unknown as Promise<ApiScanDataset>;
   }
@@ -115,7 +116,8 @@ export default class ScanDatasetApi {
     return Http.get(url, user) as unknown as Promise<ViewParameter[]>;
   }
 
-  static getNewElementsForScanDataset({ projectId, floorId, scanDatasetId }: AssociationIds, user: User): Promise<string[]> {
+  static getNewElementsForScanDataset({ projectId, floorId, scanDatasetId }: AssociationIds,
+                                      user: User): Promise<string[]> {
     const url = `${Http.baseUrl()}/projects/${projectId}/floors/${floorId}/scan-datasets/${scanDatasetId}/new-elements`;
     return Http.get(url, user) as unknown as Promise<string[]>;
   }
@@ -133,13 +135,15 @@ export default class ScanDatasetApi {
                               projectId,
                               floorId,
                               scanDatasetId
-                            }: AssociationIds, { id, photoAreaId, sessionDate }:ApiPhotoSession, user: User): Promise<ApiPhotoSession> {
+                            }: AssociationIds,
+                            { id, photoAreaId, sessionDate }: ApiPhotoSession,
+                            user: User): Promise<ApiPhotoSession> {
 
     const url = `${Http.baseUrl()}/projects/${projectId}/floors/${floorId}/scan-datasets/${scanDatasetId}/photo-session/${id}`;
-    return Http.post(url, user, {sessionDate}) as unknown as Promise<ApiPhotoSession>;
+    return Http.post(url, user, { sessionDate }) as unknown as Promise<ApiPhotoSession>;
   }
 
-  static clearVerified({projectId, floorId, scanDatasetId}: AssociationIds, user: User): Promise<void> {
+  static clearVerified({ projectId, floorId, scanDatasetId }: AssociationIds, user: User): Promise<void> {
     let url = `${Http.baseUrl()}/projects/${projectId}/floors/${floorId}/scan-datasets/${scanDatasetId}/clear-verified`;
     return Http.post(url, user) as unknown as Promise<void>;
   };

package/source/converters/date_converter.ts

@@ -1,40 +1,20 @@
 import moment, { Moment } from "moment";
-import {DateLike} from "../models";
 
-export class DateFormatter {
-  constructor(format: string) {
-    this.formatString = format;
-  }
+import DateFormatter from "./date_formatter";
+import { DateLike } from "../models";
 
-  format(date?: Date): string {
-    if (date) {
-      return moment(date).format(this.formatString);
-    } else {
-      return "";
-    }
+export class DateConverter {
+  static getLocalizedDateFormatter(): DateFormatter {
+    return new DateFormatter("l");
   }
 
-  private readonly formatString: string;
-}
-
-export class DateConverter {
-  static getDateFormatter(format: string): DateFormatter {
-    return new DateFormatter(format);
+  static getDateFormatter(format: string, secondaryFormat?: string): DateFormatter {
+    return new DateFormatter(format, secondaryFormat);
   }
 
-  static dateToText(date: Date | Moment, format?: string): string {
+  static dateToText(date: Date, format: string): string {
     if (date instanceof Date) {
-      if (format) {
-        return moment(date).format(format);
-      } else {
-        return `last scanned: ${moment(date).format("MMM D, YYYY")}`;
-      }
-    } else if (moment.isMoment(date)) {
-      if (format) {
-        return date.format(format);
-      } else {
-        return `last scanned: ${date.format("MMM D, YYYY")}`;
-      }
+      return moment(date).format(format);
     } else {
       return "";
     }
@@ -43,37 +23,40 @@ export class DateConverter {
   static instantToDate(instant: number): Date | null {
     if (typeof instant === "number") {
       const epochMillis = instant * 1000;
-      return moment(epochMillis).toDate();
+      return new Date(epochMillis);
     } else {
       return null;
     }
   }
 
-  static dateToISO(date: DateLike): string {
-    if (date == null) {
-      return ""
-    } else if (date instanceof Date || moment.isMoment(date)) {
-      return date.toISOString();
+  static dateToInstant(date: Date): number | null {
+    if (date instanceof Date) {
+      return date.getTime() / 1000;
+    } else {
+      return null;
     }
+  }
 
-    return date + "";
+  static localDateToMoment(localDate: string): Moment | null {
+    if (this.isValidDateString(localDate)) {
+      return moment(localDate);
+    }
+    return null;
   }
 
-  static dateToInstant(date: Date | Moment): number | null {
+  static dateToLocalDate(date: DateLike): string {
     if (date instanceof Date) {
-      const epochMillis = moment(date).utc(false).toDate().valueOf();
-      return epochMillis / 1000;
-    } else if (moment.isMoment(date) && date.isValid()) {
-      const epochMillis = date.utc(false).toDate().valueOf();
-      return epochMillis / 1000;
+      return date.toISOString().substring(0, 10);
+    } else if (moment.isMoment(date)) {
+      return moment(date).format("YYYY-MM-DD");
     } else {
       return null;
     }
   }
 
   static millisecondsToDate(epochMillis: number): Date | null {
-    if (epochMillis || epochMillis === 0) {
-      return moment(epochMillis).toDate();
+    if (typeof epochMillis === "number") {
+      return new Date(epochMillis);
     } else {
       return null;
     }
@@ -83,13 +66,71 @@ export class DateConverter {
     return (value instanceof Date && !isNaN(value.valueOf())) || value === null;
   }
 
-  static tsvStringToDate(dateString) {
-    if (dateString) {
+  static isValidDateString(value: string): boolean {
+    return (typeof value === "string")
+           && !!value.match(/^\d{4}-\d{2}-\d{2}$/);
+  }
+
+  static tsvStringToDate(dateString: string): Date {
+    if (typeof dateString === "string") {
       return moment(dateString, "MM/DD/YYYY").toDate();
     } else {
       return null;
     }
   }
+
+  /**
+   * truncate 2 dates to days and compare
+   * @param date1
+   * @param date2
+   * @returns true when date2 is on or after the day of date1;
+   * false if either date1 or date2 is null
+   */
+  static isOnOrAfterDay(date1: Date | string, date2: Date | string): boolean {
+    if (date1 == null || date2 == null) {
+      return false;
+    }
+
+    return this.dateToString(date1) <= this.dateToString(date2);
+  }
+
+  /**
+   * truncate 2 dates to days and compare
+   * @param date1
+   * @param date2
+   * @returns true when date2 is on the same day as date1
+   */
+  static isOnDay(date1: Date | string, date2: Date | string): boolean {
+    if (date1 == null || date2 == null) {
+      return false;
+    }
+
+    return this.dateToString(date1) === this.dateToString(date2);
+  }
+
+  private static dateToString(date: Date | string): string {
+    if (date instanceof Date) {
+      return `${this.pad(date.getUTCFullYear())}-${this.pad(date.getUTCMonth() + 1)}-${this.pad(date.getUTCDate())}`;
+    }
+    if (this.isValidDateString(date)) {
+      return date;
+    }
+    throw new TypeError("Expected date to be a Date or string");
+  }
+
+  static dateToISO(date: DateLike): string {
+    if (date == null) {
+      return "";
+    } else if (date instanceof Date || moment.isMoment(date)) {
+      return date.toISOString();
+    }
+
+    return date + "";
+  }
+
+  private static pad(i: number): string {
+    return i.toString().padStart(2, "0");
+  }
 }
 
 export default DateConverter;

package/source/converters/date_formatter.ts

@@ -0,0 +1,55 @@
+import moment from "moment";
+
+export class DateFormatter {
+  constructor(format: string, secondaryFormat?: string) {
+    this.formatString = format;
+    this.secondaryFormat = secondaryFormat;
+  }
+
+  /** Use formatLocal when displaying times relative to the user i.e. when
+   * somebody else replied to their comment, or when a file was uploaded. */
+  formatLocal(date: Date): string {
+    if (date) {
+      return moment(date).format(this.formatString);
+    } else {
+      return "";
+    }
+  }
+
+  /** Use formatUTC when all users should see the same information, regardless
+   * of their geographical location. i.e. dates pertaining to what happened on
+   * the job site */
+  formatUTC(date: moment.MomentInput): string {
+    if (date) {
+      return moment(date).utc().format(this.formatString);
+    } else {
+      return "";
+    }
+  }
+
+  formatRangeLocal(startDate: Date, endDate?: Date): string {
+    let formatted = this.formatLocal(startDate);
+    if (endDate != null) {
+      formatted += " - ";
+      let endMoment = moment(endDate);
+      if (this.secondaryFormat
+          && moment(startDate).isSame(endMoment, "day"))
+      {
+        formatted += endMoment.format(this.secondaryFormat);
+      } else {
+        formatted += this.formatLocal(endDate);
+      }
+    }
+
+    return formatted;
+  }
+
+  parseUTC(date: string | null): Date {
+    return moment.utc(date, this.formatString).toDate();
+  }
+
+  private readonly formatString: string;
+  private readonly secondaryFormat?: string;
+}
+
+export default DateFormatter;

package/source/converters/index.ts

@@ -1,5 +1,6 @@
-export {DateConverter, DateFormatter} from "./date_converter";
-export {kebabCase} from "./kebab_case";
-export {Matrix3Converter} from "./matrix_3_converter";
-export {Matrix4Converter} from "./matrix_4_converter";
-export {PurposeTypeConverter} from "./purpose_type_converter";
+export { DateConverter } from "./date_converter";
+export { DateFormatter } from "./date_formatter";
+export { kebabCase } from "./kebab_case";
+export { Matrix3Converter } from "./matrix_3_converter";
+export { Matrix4Converter } from "./matrix_4_converter";
+export { PurposeTypeConverter } from "./purpose_type_converter";

package/source/mixins/add_instant_getter_and_setter_to_api_model.ts

@@ -1,8 +1,12 @@
 import moment from "moment";
+
 import DateConverter from "../converters/date_converter";
-import {DateLike} from "../models";
+import { DateLike } from "../models";
 
-export function addInstantGetterAndSetterToApiModel(modelInstance: Object, propertyName: string, initialValue?: DateLike) {
+export function addInstantGetterAndSetterToApiModel(modelInstance: Object,
+                                                    propertyName: string,
+                                                    initialValue?: DateLike)
+{
   let dateVal;
   Object.defineProperty(modelInstance, propertyName, {
     get() {
@@ -10,9 +14,16 @@ export function addInstantGetterAndSetterToApiModel(modelInstance: Object, prope
     },
     set(val) {
       if (typeof val === "string") {
-        dateVal = DateConverter.dateToInstant(moment(val, "MMM D, YYYY").utc(true));
-      } else if (val instanceof Date || moment.isMoment(val)) {
+        const date = moment(val, "MMM D, YYYY").utc(true).toDate();
+        if (DateConverter.isValidDate(date)) {
+          dateVal = DateConverter.dateToInstant(date);
+        } else {
+          dateVal = null;
+        }
+      } else if (val instanceof Date) {
         dateVal = DateConverter.dateToInstant(val);
+      } else if (moment.isMoment(val)) {
+        dateVal = DateConverter.dateToInstant(val.toDate());
       } else {
         dateVal = val;
       }