@miso.ai/server-commons 0.6.5-beta.13 → 0.6.5-beta.15

package/package.json

@@ -6,7 +6,9 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {},
+  "scripts": {
+    "test": "npx uvu test -i 'ignored'"
+  },
   "repository": "MisoAI/miso-server-js-sdk",
   "license": "MIT",
   "contributors": [
@@ -21,5 +23,5 @@
     "uuid": "^9.0.0",
     "yargs": "^17.5.1"
   },
-  "version": "0.6.5-beta.13"
+  "version": "0.6.5-beta.15"
 }

package/src/date.js

@@ -7,8 +7,6 @@ TS_PER_UNIT.m = TS_PER_UNIT.s * 60;
 TS_PER_UNIT.h = TS_PER_UNIT.m * 60;
 TS_PER_UNIT.d = TS_PER_UNIT.h * 24;
 TS_PER_UNIT.w = TS_PER_UNIT.d * 7;
-//TS_PER_UNIT.M = TS_PER_UNIT.d * 31;
-//TS_PER_UNIT.y = TS_PER_UNIT.d * 366;
 
 export function parseDuration(expr, unit) {
   if (expr === undefined || typeof expr === 'number') {
@@ -33,69 +31,114 @@ export function getYear(dateStr) {
   return new Date(dateStr).getFullYear();
 }
 
+const RE_DATE_EXPR = /^(?:\d{4})|(?:\d{4}-[Qq\d]\d)|(?:\d{4}-\d{2}-[Ww\d]\d)$/;
+
+// TODO: support hour, minute
+
 export function startOfDate(expr) {
   if (expr === undefined) {
     return undefined;
   }
-  if (typeof expr === 'number') {
-    if (expr < 10000) {
-      expr = startOfYearByYearNum(expr);
-    }
-    return expr;
-  }
-  const ts = Date.parse(expr);
-  if (isNaN(ts)) {
-    throw new Error(`Unrecognized date: ${expr}`);
+  const parsed = parseDateExpr(expr);
+  switch (parsed.type) {
+    case 'ts':
+      return parsed.ts;
+    case 'year':
+      return Date.UTC(parsed.year);
+    case 'quarter':
+      return Date.UTC(parsed.year, (parsed.quarter - 1) * 3);
+    case 'month':
+      return Date.UTC(parsed.year, parsed.month - 1);
+    case 'week':
+      return Date.UTC(parsed.year, parsed.month - 1, (parsed.week - 1) * 7 + 1);
+    case 'day':
+      return Date.UTC(parsed.year, parsed.month - 1, parsed.day);
+    default:
+      throw new Error(`Unrecognized date: ${expr}`);
   }
-  return ts;
 }
 
-const RE_YEAR = /^\d{4}$/g;
-const RE_MONTH = /^\d{4}-\d{2}$/g;
-const RE_DATE = /^\d{4}-\d{2}-\d{2}$/g;
-
-// TODO: support end of hour, minute
-
-export function endOfDate(expr) {
+export function nextOfDate(expr) {
   if (expr === undefined) {
     return undefined;
   }
-  if (typeof expr === 'number') {
-    if (expr < 10000) {
-      expr = endOfYearByYearNum(expr);
-    }
-    return expr;
-  }
-  let ts = Date.parse(expr);
-  if (isNaN(ts)) {
-    throw new Error(`Unrecognized date: ${expr}`);
+  const parsed = parseDateExpr(expr);
+  switch (parsed.type) {
+    case 'ts':
+      return parsed.ts + 1;
+    case 'year':
+      return Date.UTC(parsed.year + 1);
+    case 'quarter':
+      return Date.UTC(parsed.year, parsed.quarter * 3);
+    case 'month':
+      return Date.UTC(parsed.year, parsed.month);
+    case 'week':
+      // roll over to 1st of next month if week is 4
+      return Date.UTC(parsed.year, parsed.week < 4 ? parsed.month - 1 : parsed.month, (parsed.week % 4) * 7 + 1);
+    case 'day':
+      return Date.UTC(parsed.year, parsed.month - 1, parsed.day + 1);
+    default:
+      throw new Error(`Unrecognized date: ${expr}`);
   }
-  return expr.match(RE_YEAR) ? endOfYear(ts) :
-    expr.match(RE_MONTH) ? endOfMonth(ts) :
-    expr.match(RE_DATE) ? endOfDay(ts) : ts;
 }
 
-function endOfYear(ts) {
-  return endOfYearByYearNum(new Date(ts).getFullYear());
-}
-
-function startOfYearByYearNum(fullYear) {
-  return new Date(fullYear, 0, 1).getTime();
-}
-
-function endOfYearByYearNum(fullYear) {
-  return new Date(fullYear + 1, 0, 1).getTime() - 1000;
-}
-
-function endOfMonth(ts) {
-  const date = new Date(ts);
-  const year = date.getFullYear();
-  const month = date.getMonth();
-  return (month == 11 ? new Date(year + 1, 0, 1) : new Date(year, month + 1, 1)).getTime() - 1000;
+export function endOfDate(expr) {
+  if (expr === undefined) {
+    return undefined;
+  }
+  return nextOfDate(expr) - 1000; // 1 sec
 }
 
-const MS_PER_DAY = 1000 * 60 * 60 * 24;
-
-function endOfDay(ts) {
-  return (Math.floor(ts / MS_PER_DAY) + 1) * MS_PER_DAY - 1000;
+function parseDateExpr(expr) {
+  switch (typeof expr) {
+    case 'number':
+      if (expr < 100) {
+        throw new Error(`Unrecognized date: ${expr}`);
+      }
+      return expr < 10000 ? { type: 'year', year: expr } : { type: 'ts', ts: expr };
+    case 'string':
+      expr = expr.trim();
+      const len = expr.length;
+      if (!RE_DATE_EXPR.test(expr)) {
+        throw new Error(`Unrecognized date: ${expr}`);
+      }
+      const year = parseInt(expr.slice(0, 4), 10);
+      if (isNaN(year)) {
+        throw new Error(`Unrecognized date: ${expr}`);
+      }
+      if (len === 4) {
+        return { type: 'year', year };
+      }
+      if (len === 7 && (expr.charAt(5) === 'Q' || expr.charAt(5) === 'q')) {
+        const quarter = parseInt(expr.charAt(6), 10);
+        if (isNaN(quarter) || quarter < 1 || quarter > 4) {
+          throw new Error(`Unrecognized date: ${expr}`);
+        }
+        return { type: 'quarter', year, quarter };
+      }
+      const month = parseInt(expr.slice(5, 7), 10);
+      if (isNaN(month) || month < 1 || month > 12) {
+        throw new Error(`Unrecognized date: ${expr}`);
+      }
+      if (len === 7) {
+        return { type: 'month', year, month };
+      }
+      if (expr.charAt(8) === 'W' || expr.charAt(8) === 'w') {
+        const week = parseInt(expr.charAt(9), 10);
+        if (isNaN(week) || week < 1 || week > 4) {
+          throw new Error(`Unrecognized date: ${expr}`);
+        }
+        return { type: 'week', year, month, week };
+      }
+      let date;
+      try {
+        // parse so we can validate the day part
+        date = new Date(Date.parse(expr));
+      } catch (_) {
+        throw new Error(`Unrecognized date: ${expr}`);
+      }
+      return { type: 'day', year, month, day: date.getUTCDate() };
+    default:
+      throw new Error(`Unrecognized date: ${expr}`);
+  }
 }

package/test/date.test.js

@@ -0,0 +1,31 @@
+import { test } from 'uvu';
+import * as assert from 'uvu/assert';
+import { startOfDate, endOfDate } from '../src/index.js';
+
+test('startOfDate', () => {
+  assert.equal(startOfDate('2025'), Date.parse('2025-01-01T00:00:00Z'));
+  assert.equal(startOfDate('2025-Q1'), Date.parse('2025-01-01T00:00:00Z'));
+  assert.equal(startOfDate('2025-q2'), Date.parse('2025-04-01T00:00:00Z'));
+  assert.equal(startOfDate('2025-Q3'), Date.parse('2025-07-01T00:00:00Z'));
+  assert.equal(startOfDate('2025-q4'), Date.parse('2025-10-01T00:00:00Z'));
+  assert.equal(startOfDate('2025-02'), Date.parse('2025-02-01T00:00:00Z'));
+  assert.equal(startOfDate('2025-02-W1'), Date.parse('2025-02-01T00:00:00Z'));
+  assert.equal(startOfDate('2025-02-w2'), Date.parse('2025-02-08T00:00:00Z'));
+  assert.equal(startOfDate('2025-02-03'), Date.parse('2025-02-03T00:00:00Z'));
+});
+
+test('endOfDate', () => {
+  assert.equal(endOfDate('2025'), Date.parse('2025-12-31T23:59:59Z'));
+  assert.equal(endOfDate('2025-Q1'), Date.parse('2025-03-31T23:59:59Z'));
+  assert.equal(endOfDate('2025-q2'), Date.parse('2025-06-30T23:59:59Z'));
+  assert.equal(endOfDate('2025-Q3'), Date.parse('2025-09-30T23:59:59Z'));
+  assert.equal(endOfDate('2025-q4'), Date.parse('2025-12-31T23:59:59Z'));
+  assert.equal(endOfDate('2025-02'), Date.parse('2025-02-28T23:59:59Z'));
+  assert.equal(endOfDate('2025-03-W1'), Date.parse('2025-03-07T23:59:59Z'));
+  assert.equal(endOfDate('2025-03-w2'), Date.parse('2025-03-14T23:59:59Z'));
+  assert.equal(endOfDate('2025-03-W3'), Date.parse('2025-03-21T23:59:59Z'));
+  assert.equal(endOfDate('2025-03-w4'), Date.parse('2025-03-31T23:59:59Z'));
+  assert.equal(endOfDate('2025-03-03'), Date.parse('2025-03-03T23:59:59Z'));
+});
+
+test.run();