@higher.archi/boe 1.0.0

package/src/core/operators/date/comparisons.ts

@@ -0,0 +1,124 @@
+/**
+ * Date Comparison Operators
+ *
+ * Operators that compare two dates.
+ * Takes (Date, Date) and returns a boolean.
+ */
+
+import { binaryOp } from '../operator';
+import { Operator } from '../types';
+
+// =============================================================================
+// Helper Functions
+// =============================================================================
+
+/**
+ * Get the ISO week number for a date
+ */
+function getISOWeek(date: Date): number {
+  const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+  d.setUTCDate(d.getUTCDate() + 4 - (d.getUTCDay() || 7));
+  const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+  return Math.ceil((((d.getTime() - yearStart.getTime()) / 86400000) + 1) / 7);
+}
+
+// =============================================================================
+// Comparison Operators
+// =============================================================================
+
+export const isBefore: Operator = binaryOp<Date, Date>(
+  'isBefore',
+  (a, b) => a.getTime() < b.getTime(),
+  {
+    leftType: 'date',
+    rightType: 'date',
+    returns: 'boolean',
+    category: 'date',
+    description: 'Returns true if the first date is before the second date',
+  }
+);
+
+export const isAfter: Operator = binaryOp<Date, Date>(
+  'isAfter',
+  (a, b) => a.getTime() > b.getTime(),
+  {
+    leftType: 'date',
+    rightType: 'date',
+    returns: 'boolean',
+    category: 'date',
+    description: 'Returns true if the first date is after the second date',
+  }
+);
+
+export const isSameDay: Operator = binaryOp<Date, Date>(
+  'isSameDay',
+  (a, b) => {
+    return (
+      a.getFullYear() === b.getFullYear() &&
+      a.getMonth() === b.getMonth() &&
+      a.getDate() === b.getDate()
+    );
+  },
+  {
+    leftType: 'date',
+    rightType: 'date',
+    returns: 'boolean',
+    category: 'date',
+    description: 'Returns true if both dates are on the same calendar day',
+  }
+);
+
+export const isSameWeek: Operator = binaryOp<Date, Date>(
+  'isSameWeek',
+  (a, b) => {
+    return (
+      a.getFullYear() === b.getFullYear() &&
+      getISOWeek(a) === getISOWeek(b)
+    );
+  },
+  {
+    leftType: 'date',
+    rightType: 'date',
+    returns: 'boolean',
+    category: 'date',
+    description: 'Returns true if both dates are in the same ISO week',
+  }
+);
+
+export const isSameMonth: Operator = binaryOp<Date, Date>(
+  'isSameMonth',
+  (a, b) => {
+    return (
+      a.getFullYear() === b.getFullYear() &&
+      a.getMonth() === b.getMonth()
+    );
+  },
+  {
+    leftType: 'date',
+    rightType: 'date',
+    returns: 'boolean',
+    category: 'date',
+    description: 'Returns true if both dates are in the same month and year',
+  }
+);
+
+export const isSameYear: Operator = binaryOp<Date, Date>(
+  'isSameYear',
+  (a, b) => a.getFullYear() === b.getFullYear(),
+  {
+    leftType: 'date',
+    rightType: 'date',
+    returns: 'boolean',
+    category: 'date',
+    description: 'Returns true if both dates are in the same year',
+  }
+);
+
+export default [
+  isBefore,
+  isAfter,
+  isSameDay,
+  isSameWeek,
+  isSameMonth,
+  isSameYear,
+];

package/src/core/operators/date/constants.ts

@@ -0,0 +1,102 @@
+/**
+ * Date Constant Operators
+ *
+ * Operators that return special date constants.
+ * These are effectively nullary but use unaryOp with ignored input.
+ */
+
+import { unaryOp } from '../operator';
+import { Operator } from '../types';
+
+// =============================================================================
+// Constant Operators
+// =============================================================================
+
+/**
+ * Returns the current date and time.
+ * Input is ignored - pass any value (e.g., 0 or null).
+ *
+ * Usage: ['now', 0]
+ */
+export const now: Operator = unaryOp<any>(
+  'now',
+  (_) => new Date(),
+  {
+    paramType: 'any',
+    returns: 'date',
+    category: 'date',
+    description: 'Returns the current date and time',
+  }
+);
+
+/**
+ * Returns the start of today (midnight).
+ * Input is ignored - pass any value (e.g., 0 or null).
+ *
+ * Usage: ['today', 0]
+ */
+export const today: Operator = unaryOp<any>(
+  'today',
+  (_) => {
+    const d = new Date();
+    d.setHours(0, 0, 0, 0);
+    return d;
+  },
+  {
+    paramType: 'any',
+    returns: 'date',
+    category: 'date',
+    description: 'Returns the start of today (midnight)',
+  }
+);
+
+/**
+ * Returns the start of tomorrow (midnight).
+ * Input is ignored - pass any value (e.g., 0 or null).
+ *
+ * Usage: ['tomorrow', 0]
+ */
+export const tomorrow: Operator = unaryOp<any>(
+  'tomorrow',
+  (_) => {
+    const d = new Date();
+    d.setDate(d.getDate() + 1);
+    d.setHours(0, 0, 0, 0);
+    return d;
+  },
+  {
+    paramType: 'any',
+    returns: 'date',
+    category: 'date',
+    description: 'Returns the start of tomorrow (midnight)',
+  }
+);
+
+/**
+ * Returns the start of yesterday (midnight).
+ * Input is ignored - pass any value (e.g., 0 or null).
+ *
+ * Usage: ['yesterday', 0]
+ */
+export const yesterday: Operator = unaryOp<any>(
+  'yesterday',
+  (_) => {
+    const d = new Date();
+    d.setDate(d.getDate() - 1);
+    d.setHours(0, 0, 0, 0);
+    return d;
+  },
+  {
+    paramType: 'any',
+    returns: 'date',
+    category: 'date',
+    description: 'Returns the start of yesterday (midnight)',
+  }
+);
+
+export default [
+  now,
+  today,
+  tomorrow,
+  yesterday,
+];

package/src/core/operators/date/differences.ts

@@ -0,0 +1,150 @@
+/**
+ * Date Difference Operators
+ *
+ * Operators that compute the difference between two dates.
+ * Takes (Date, Date) and returns a number.
+ */
+
+import { binaryOp } from '../operator';
+import { Operator } from '../types';
+
+// =============================================================================
+// Time Constants
+// =============================================================================
+
+const MS_PER_SECOND = 1000;
+const MS_PER_MINUTE = 60 * MS_PER_SECOND;
+const MS_PER_HOUR = 60 * MS_PER_MINUTE;
+const MS_PER_DAY = 24 * MS_PER_HOUR;
+const MS_PER_WEEK = 7 * MS_PER_DAY;
+
+// =============================================================================
+// Helper Functions
+// =============================================================================
+
+/**
+ * Calculate the difference in months between two dates
+ */
+function monthDiff(a: Date, b: Date): number {
+  const years = b.getFullYear() - a.getFullYear();
+  const months = b.getMonth() - a.getMonth();
+  return years * 12 + months;
+}
+
+/**
+ * Calculate the difference in years between two dates
+ */
+function yearDiff(a: Date, b: Date): number {
+  return b.getFullYear() - a.getFullYear();
+}
+
+// =============================================================================
+// Difference Operators
+// =============================================================================
+
+export const diffMilliseconds: Operator = binaryOp<Date, Date>(
+  'diffMilliseconds',
+  (a, b) => b.getTime() - a.getTime(),
+  {
+    leftType: 'date',
+    rightType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the difference in milliseconds between two dates (b - a)',
+  }
+);
+
+export const diffSeconds: Operator = binaryOp<Date, Date>(
+  'diffSeconds',
+  (a, b) => Math.floor((b.getTime() - a.getTime()) / MS_PER_SECOND),
+  {
+    leftType: 'date',
+    rightType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the difference in seconds between two dates (b - a)',
+  }
+);
+
+export const diffMinutes: Operator = binaryOp<Date, Date>(
+  'diffMinutes',
+  (a, b) => Math.floor((b.getTime() - a.getTime()) / MS_PER_MINUTE),
+  {
+    leftType: 'date',
+    rightType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the difference in minutes between two dates (b - a)',
+  }
+);
+
+export const diffHours: Operator = binaryOp<Date, Date>(
+  'diffHours',
+  (a, b) => Math.floor((b.getTime() - a.getTime()) / MS_PER_HOUR),
+  {
+    leftType: 'date',
+    rightType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the difference in hours between two dates (b - a)',
+  }
+);
+
+export const diffDays: Operator = binaryOp<Date, Date>(
+  'diffDays',
+  (a, b) => Math.floor((b.getTime() - a.getTime()) / MS_PER_DAY),
+  {
+    leftType: 'date',
+    rightType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the difference in days between two dates (b - a)',
+  }
+);
+
+export const diffWeeks: Operator = binaryOp<Date, Date>(
+  'diffWeeks',
+  (a, b) => Math.floor((b.getTime() - a.getTime()) / MS_PER_WEEK),
+  {
+    leftType: 'date',
+    rightType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the difference in weeks between two dates (b - a)',
+  }
+);
+
+export const diffMonths: Operator = binaryOp<Date, Date>(
+  'diffMonths',
+  (a, b) => monthDiff(a, b),
+  {
+    leftType: 'date',
+    rightType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the difference in months between two dates (b - a)',
+  }
+);
+
+export const diffYears: Operator = binaryOp<Date, Date>(
+  'diffYears',
+  (a, b) => yearDiff(a, b),
+  {
+    leftType: 'date',
+    rightType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the difference in years between two dates (b - a)',
+  }
+);
+
+export default [
+  diffMilliseconds,
+  diffSeconds,
+  diffMinutes,
+  diffHours,
+  diffDays,
+  diffWeeks,
+  diffMonths,
+  diffYears,
+];

package/src/core/operators/date/extraction.ts

@@ -0,0 +1,145 @@
+/**
+ * Date Extraction Operators
+ *
+ * Operators that extract components from a date.
+ * Takes a Date and returns a number.
+ */
+
+import { unaryOp } from '../operator';
+import { Operator } from '../types';
+
+// =============================================================================
+// Helper Functions
+// =============================================================================
+
+/**
+ * Get the ISO week number for a date
+ */
+function getISOWeekNumber(date: Date): number {
+  const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+  d.setUTCDate(d.getUTCDate() + 4 - (d.getUTCDay() || 7));
+  const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+  return Math.ceil((((d.getTime() - yearStart.getTime()) / 86400000) + 1) / 7);
+}
+
+/**
+ * Get the quarter (1-4) for a date
+ */
+function getQuarterNumber(date: Date): number {
+  return Math.floor(date.getMonth() / 3) + 1;
+}
+
+// =============================================================================
+// Extraction Operators
+// =============================================================================
+
+export const getYear: Operator = unaryOp<Date>(
+  'getYear',
+  (date) => date.getFullYear(),
+  {
+    paramType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the 4-digit year from a date',
+  }
+);
+
+export const getMonth: Operator = unaryOp<Date>(
+  'getMonth',
+  (date) => date.getMonth() + 1, // 1-12 instead of 0-11
+  {
+    paramType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the month (1-12) from a date',
+  }
+);
+
+export const getDay: Operator = unaryOp<Date>(
+  'getDay',
+  (date) => date.getDate(),
+  {
+    paramType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the day of month (1-31) from a date',
+  }
+);
+
+export const getDayOfWeek: Operator = unaryOp<Date>(
+  'getDayOfWeek',
+  (date) => date.getDay(),
+  {
+    paramType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the day of week (0-6, Sunday=0) from a date',
+  }
+);
+
+export const getHour: Operator = unaryOp<Date>(
+  'getHour',
+  (date) => date.getHours(),
+  {
+    paramType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the hour (0-23) from a date',
+  }
+);
+
+export const getMinute: Operator = unaryOp<Date>(
+  'getMinute',
+  (date) => date.getMinutes(),
+  {
+    paramType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the minute (0-59) from a date',
+  }
+);
+
+export const getSecond: Operator = unaryOp<Date>(
+  'getSecond',
+  (date) => date.getSeconds(),
+  {
+    paramType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the second (0-59) from a date',
+  }
+);
+
+export const getQuarter: Operator = unaryOp<Date>(
+  'getQuarter',
+  (date) => getQuarterNumber(date),
+  {
+    paramType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the quarter (1-4) from a date',
+  }
+);
+
+export const getWeekOfYear: Operator = unaryOp<Date>(
+  'getWeekOfYear',
+  (date) => getISOWeekNumber(date),
+  {
+    paramType: 'date',
+    returns: 'number',
+    category: 'date',
+    description: 'Returns the ISO week of year (1-53) from a date',
+  }
+);
+
+export default [
+  getYear,
+  getMonth,
+  getDay,
+  getDayOfWeek,
+  getHour,
+  getMinute,
+  getSecond,
+  getQuarter,
+  getWeekOfYear,
+];