@ehmpathy/uni-time 1.1.0 → 1.3.0

package/dist/casts/castInputToDate.d.ts

@@ -0,0 +1,11 @@
+import { PickOne } from 'type-fns';
+export declare const castInputToDate: (input: string | Date | PickOne<{
+    /**
+     * milliseconds since epoch
+     */
+    mse: number;
+    /**
+     * a date
+     */
+    date: Date;
+}>) => Date;

package/dist/casts/castInputToDate.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.castInputToDate = void 0;
+const error_fns_1 = require("@ehmpathy/error-fns");
+const castInputToDate = (input) => {
+    if (input instanceof Date)
+        return input;
+    if (typeof input === 'string')
+        return new Date(input);
+    if (input.date)
+        return input.date;
+    if (input.mse)
+        return new Date(input.mse);
+    throw new error_fns_1.UnexpectedCodePathError('could not parse date from input', {
+        input,
+    });
+};
+exports.castInputToDate = castInputToDate;
+//# sourceMappingURL=castInputToDate.js.map

package/dist/casts/castInputToDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"castInputToDate.js","sourceRoot":"","sources":["../../src/casts/castInputToDate.ts"],"names":[],"mappings":";;;AAAA,mDAA8D;AAGvD,MAAM,eAAe,GAAG,CAC7B,KAaM,EACA,EAAE;IACR,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,KAAK,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IAClC,IAAI,KAAK,CAAC,GAAG;QAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,IAAI,mCAAuB,CAAC,iCAAiC,EAAE;QACnE,KAAK;KACN,CAAC,CAAC;AACL,CAAC,CAAC;AAvBW,QAAA,eAAe,mBAuB1B"}

package/dist/casts/toMillisecondsSinceEpoch.d.ts

@@ -0,0 +1,3 @@
+import { UniDate, UniDateTime } from '../domain/UniDateTime';
+export declare const toMillisecondsSinceEpoch: (input: UniDate | UniDateTime) => number;
+export { toMillisecondsSinceEpoch as toMse };

package/dist/casts/toMillisecondsSinceEpoch.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toMse = exports.toMillisecondsSinceEpoch = void 0;
+const toMillisecondsSinceEpoch = (input) => new Date(input).getTime();
+exports.toMillisecondsSinceEpoch = toMillisecondsSinceEpoch;
+exports.toMse = exports.toMillisecondsSinceEpoch;
+//# sourceMappingURL=toMillisecondsSinceEpoch.js.map

package/dist/casts/toMillisecondsSinceEpoch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toMillisecondsSinceEpoch.js","sourceRoot":"","sources":["../../src/casts/toMillisecondsSinceEpoch.ts"],"names":[],"mappings":";;;AAEO,MAAM,wBAAwB,GAAG,CACtC,KAA4B,EACpB,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;AAF1B,QAAA,wBAAwB,4BAEE;AAEF,gBAJxB,gCAAwB,CAIK"}

package/dist/checks/isUniDate.d.ts

@@ -0,0 +1,10 @@
+import { castInputToDate } from '../casts/castInputToDate';
+import { UniDate } from '../domain/UniDateTime';
+/**
+ * casts a date like input into a UniDate
+ */
+export declare const asUniDate: (input: Parameters<typeof castInputToDate>[0]) => UniDate;
+/**
+ * checks whether a string literal input is a UniDate
+ */
+export declare const isUniDate: import("type-fns").AssessWithAssure<string, string & import("domain-glossaries").OfGlossary<"uni-time">>;

package/dist/checks/isUniDate.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isUniDate = exports.asUniDate = void 0;
+const date_fns_1 = require("date-fns");
+const type_fns_1 = require("type-fns");
+const castInputToDate_1 = require("../casts/castInputToDate");
+/**
+ * casts a date like input into a UniDate
+ */
+const asUniDate = (input) => (0, date_fns_1.format)((0, castInputToDate_1.castInputToDate)(input), 'yyyy-MM-dd');
+exports.asUniDate = asUniDate;
+/**
+ * checks whether a string literal input is a UniDate
+ */
+exports.isUniDate = (0, type_fns_1.withAssure)((input) => {
+    try {
+        return (0, exports.asUniDate)((0, date_fns_1.parseISO)(input)) === input;
+    }
+    catch (_a) {
+        return false;
+    }
+});
+//# sourceMappingURL=isUniDate.js.map

package/dist/checks/isUniDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isUniDate.js","sourceRoot":"","sources":["../../src/checks/isUniDate.ts"],"names":[],"mappings":";;;AAAA,uCAA4C;AAC5C,uCAAsC;AAEtC,8DAA2D;AAG3D;;GAEG;AACI,MAAM,SAAS,GAAG,CACvB,KAA4C,EACnC,EAAE,CAAC,IAAA,iBAAM,EAAC,IAAA,iCAAe,EAAC,KAAK,CAAC,EAAE,YAAY,CAAY,CAAC;AAFzD,QAAA,SAAS,aAEgD;AAEtE;;GAEG;AACU,QAAA,SAAS,GAAG,IAAA,qBAAU,EAAC,CAAC,KAAa,EAAoB,EAAE;IACtE,IAAI,CAAC;QACH,OAAO,IAAA,iBAAS,EAAC,IAAA,mBAAQ,EAAC,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC;IAC9C,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/checks/isUniDate.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/checks/isUniDate.test.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const isUniDate_1 = require("./isUniDate");
+describe('isUniDate', () => {
+    const cases = [
+        {
+            input: 'May 15, 2024',
+            output: false,
+        },
+        {
+            input: '05-15-2024',
+            output: false,
+        },
+        {
+            input: '2024-05-15T17:21:55.555Z',
+            output: false,
+        },
+        {
+            input: '2024-05-15',
+            output: true,
+        },
+    ];
+    cases.forEach((thisCase) => it(`should return ${thisCase.output} for '${thisCase.input}'`, () => {
+        expect((0, isUniDate_1.isUniDate)(thisCase.input)).toEqual(thisCase.output);
+    }));
+});
+//# sourceMappingURL=isUniDate.test.js.map

package/dist/checks/isUniDate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isUniDate.test.js","sourceRoot":"","sources":["../../src/checks/isUniDate.test.ts"],"names":[],"mappings":";;AAAA,2CAAwC;AAExC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,MAAM,KAAK,GAAyC;QAClD;YACE,KAAK,EAAE,cAAc;YACrB,MAAM,EAAE,KAAK;SACd;QACD;YACE,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,KAAK;SACd;QACD;YACE,KAAK,EAAE,0BAA0B;YACjC,MAAM,EAAE,KAAK;SACd;QACD;YACE,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,IAAI;SACb;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CACzB,EAAE,CAAC,iBAAiB,QAAQ,CAAC,MAAM,SAAS,QAAQ,CAAC,KAAK,GAAG,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,IAAA,qBAAS,EAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7D,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/checks/isUniDateTime.d.ts

@@ -0,0 +1,10 @@
+import { castInputToDate } from '../casts/castInputToDate';
+import { UniDateTime } from '../domain/UniDateTime';
+/**
+ * casts a datetime like input into a uniDateTime
+ */
+export declare const asUniDateTime: (input: Parameters<typeof castInputToDate>[0]) => UniDateTime;
+/**
+ * checks whether a string literal input is a UniDateTime
+ */
+export declare const isUniDateTime: import("type-fns").AssessWithAssure<string, string & import("domain-glossaries").OfGlossary<"uni-time">>;

package/dist/checks/isUniDateTime.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isUniDateTime = exports.asUniDateTime = void 0;
+const date_fns_1 = require("date-fns");
+const type_fns_1 = require("type-fns");
+const castInputToDate_1 = require("../casts/castInputToDate");
+/**
+ * casts a datetime like input into a uniDateTime
+ */
+const asUniDateTime = (input) => (0, castInputToDate_1.castInputToDate)(input).toISOString();
+exports.asUniDateTime = asUniDateTime;
+/**
+ * checks whether a string literal input is a UniDateTime
+ */
+exports.isUniDateTime = (0, type_fns_1.withAssure)((input) => {
+    try {
+        return (0, exports.asUniDateTime)((0, date_fns_1.parseISO)(input)) === input;
+    }
+    catch (_a) {
+        return false;
+    }
+});
+//# sourceMappingURL=isUniDateTime.js.map

package/dist/checks/isUniDateTime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isUniDateTime.js","sourceRoot":"","sources":["../../src/checks/isUniDateTime.ts"],"names":[],"mappings":";;;AAAA,uCAAoC;AACpC,uCAAsC;AAEtC,8DAA2D;AAG3D;;GAEG;AACI,MAAM,aAAa,GAAG,CAC3B,KAA4C,EAC/B,EAAE,CAAC,IAAA,iCAAe,EAAC,KAAK,CAAC,CAAC,WAAW,EAAiB,CAAC;AAFzD,QAAA,aAAa,iBAE4C;AAEtE;;GAEG;AACU,QAAA,aAAa,GAAG,IAAA,qBAAU,EACrC,CAAC,KAAa,EAAwB,EAAE;IACtC,IAAI,CAAC;QACH,OAAO,IAAA,qBAAa,EAAC,IAAA,mBAAQ,EAAC,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC;IAClD,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CACF,CAAC"}

package/dist/checks/isUniDateTime.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/checks/isUniDateTime.test.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const isUniDateTime_1 = require("./isUniDateTime");
+describe('isUniDateTime', () => {
+    const cases = [
+        {
+            input: 'May 15, 2024 at 5pm',
+            output: false,
+        },
+        {
+            input: '2024-05-15 17:21:55',
+            output: false,
+        },
+        {
+            input: '2024-05-15T17:21:55Z',
+            output: false,
+        },
+        {
+            input: '2024-05-15T17:21:55.555Z',
+            output: true,
+        },
+    ];
+    cases.forEach((thisCase) => it(`should return ${thisCase.output} for '${thisCase.input}'`, () => {
+        expect((0, isUniDateTime_1.isUniDateTime)(thisCase.input)).toEqual(thisCase.output);
+    }));
+});
+//# sourceMappingURL=isUniDateTime.test.js.map

package/dist/checks/isUniDateTime.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isUniDateTime.test.js","sourceRoot":"","sources":["../../src/checks/isUniDateTime.test.ts"],"names":[],"mappings":";;AAAA,mDAAgD;AAEhD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,MAAM,KAAK,GAAyC;QAClD;YACE,KAAK,EAAE,qBAAqB;YAC5B,MAAM,EAAE,KAAK;SACd;QACD;YACE,KAAK,EAAE,qBAAqB;YAC5B,MAAM,EAAE,KAAK;SACd;QACD;YACE,KAAK,EAAE,sBAAsB;YAC7B,MAAM,EAAE,KAAK;SACd;QACD;YACE,KAAK,EAAE,0BAA0B;YACjC,MAAM,EAAE,IAAI;SACb;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CACzB,EAAE,CAAC,iBAAiB,QAAQ,CAAC,MAAM,SAAS,QAAQ,CAAC,KAAK,GAAG,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,IAAA,6BAAa,EAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/domain/UniDateTime.d.ts

@@ -1,25 +1,12 @@
 import { AsOfGlossary } from 'domain-glossaries';
-import { PickOne } from 'type-fns';
-declare const castInputToDate: (input: string | Date | PickOne<{
-    /**
-     * milliseconds since epoch
-     */
-    mse: number;
-    /**
-     * a date
-     */
-    date: Date;
-}>) => Date;
 /**
  * a universally unambiguous datetime serialized as a string; yyyy-MM-ddThh:mm:ssZ
  */
 export type UniDateTime = AsOfGlossary<string, 'uni-time'>;
-export declare const asUniDateTime: (input: Parameters<typeof castInputToDate>[0]) => UniDateTime;
 /**
  * a universally unambiguous date serialized as a string; yyyy-MM-dd
  */
 export type UniDate = AsOfGlossary<string, 'uni-time'>;
-export declare const asUniDate: (input: Parameters<typeof castInputToDate>[0]) => UniDate;
 /**
  * a universally unambiguous month serialized as a string; yyyy-MM
  */
@@ -46,4 +33,3 @@ export type UniDateTimeRange = AsOfGlossary<{
     since: UniDateTime;
     until: UniDateTime;
 }, 'uni-time', false>;
-export {};

package/dist/domain/UniDateTime.js

@@ -1,23 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.asUniDate = exports.asUniDateTime = void 0;
-const error_fns_1 = require("@ehmpathy/error-fns");
-const date_fns_1 = require("date-fns");
-const castInputToDate = (input) => {
-    if (input instanceof Date)
-        return input;
-    if (typeof input === 'string')
-        return new Date(input);
-    if (input.date)
-        return input.date;
-    if (input.mse)
-        return new Date(input.mse);
-    throw new error_fns_1.UnexpectedCodePathError('could not parse date from input', {
-        input,
-    });
-};
-const asUniDateTime = (input) => castInputToDate(input).toISOString();
-exports.asUniDateTime = asUniDateTime;
-const asUniDate = (input) => (0, date_fns_1.format)(castInputToDate(input), 'yyyy-MM-dd');
-exports.asUniDate = asUniDate;
 //# sourceMappingURL=UniDateTime.js.map

package/dist/domain/UniDateTime.js.map

@@ -1 +1 @@
-{"version":3,"file":"UniDateTime.js","sourceRoot":"","sources":["../../src/domain/UniDateTime.ts"],"names":[],"mappings":";;;AAAA,mDAA8D;AAC9D,uCAAkC;AAIlC,MAAM,eAAe,GAAG,CACtB,KAaM,EACN,EAAE;IACF,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,KAAK,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IAClC,IAAI,KAAK,CAAC,GAAG;QAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,IAAI,mCAAuB,CAAC,iCAAiC,EAAE;QACnE,KAAK;KACN,CAAC,CAAC;AACL,CAAC,CAAC;AAMK,MAAM,aAAa,GAAG,CAC3B,KAA4C,EAC/B,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,WAAW,EAAiB,CAAC;AAFzD,QAAA,aAAa,iBAE4C;AAM/D,MAAM,SAAS,GAAG,CACvB,KAA4C,EACnC,EAAE,CAAC,IAAA,iBAAM,EAAC,eAAe,CAAC,KAAK,CAAC,EAAE,YAAY,CAAY,CAAC;AAFzD,QAAA,SAAS,aAEgD"}
+{"version":3,"file":"UniDateTime.js","sourceRoot":"","sources":["../../src/domain/UniDateTime.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -1,3 +1,6 @@
 export * from './domain/UniDateTime';
 export * from './domain/UniDuration';
 export * from './utils/sleep';
+export * from './checks/isUniDate';
+export * from './checks/isUniDateTime';
+export * from './casts/toMillisecondsSinceEpoch';

package/dist/index.js

@@ -17,4 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./domain/UniDateTime"), exports);
 __exportStar(require("./domain/UniDuration"), exports);
 __exportStar(require("./utils/sleep"), exports);
+__exportStar(require("./checks/isUniDate"), exports);
+__exportStar(require("./checks/isUniDateTime"), exports);
+__exportStar(require("./casts/toMillisecondsSinceEpoch"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,uDAAqC;AACrC,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,uDAAqC;AACrC,gDAA8B;AAC9B,qDAAmC;AACnC,yDAAuC;AACvC,mEAAiD"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@ehmpathy/uni-time",
   "author": "ehmpathy",
   "description": "a glossary of universally intuitive time, date, and duration domain literals",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "repository": "ehmpathy/uni-time",
   "homepage": "https://github.com/ehmpathy/uni-time",
   "keywords": [
@@ -52,7 +52,7 @@
     "@ehmpathy/error-fns": "1.0.2",
     "date-fns": "3.6.0",
     "domain-glossaries": "1.0.0",
-    "type-fns": "0.8.1"
+    "type-fns": "1.15.0"
   },
   "devDependencies": {
     "@commitlint/cli": "17.6.7",