@wisemen/datewise 0.0.1

package/README.md

@@ -0,0 +1,307 @@
+# @wisemen/datewise
+
+A comprehensive TypeScript library for working with dates, times, and ranges in a type-safe and immutable way. Built on top of Day.js, it provides specialized types and utilities for temporal operations with strong TypeORM integration.
+
+## Features
+
+- **PlainDate**: Date-only type without time or timezone information
+- **PlainTime**: Time-only type (hours, minutes, seconds, milliseconds)
+- **Timestamp**: Date and time with timezone support
+- **DateRange**: Inclusive/exclusive ranges between two dates
+- **DateTimeRange**: Inclusive/exclusive ranges between two timestamps
+- **MultiDateTimeRange**: Multiple non-overlapping datetime ranges
+- **RRule**: Recurring date/time patterns
+- **TypeORM Integration**: Custom column types and query operators
+- **Class Validator Decorators**: Built-in validation decorators
+- **NestJS Support**: DTO builders and API property decorators
+- **Immutable API**: All operations return new instances
+
+## Installation
+
+```bash
+pnpm add @wisemen/datewise
+```
+
+### Peer Dependencies
+
+```bash
+pnpm add dayjs typeorm class-validator class-transformer @nestjs/swagger
+```
+
+## Philosophy
+
+This package embraces immutability and type safety for temporal operations. Unlike native JavaScript `Date` objects or raw Day.js instances, `datewise` provides:
+
+1. **Separation of Concerns**: Distinct types for dates, times, and timestamps prevent mixing incompatible temporal concepts
+2. **Explicit Timezone Handling**: Timestamps carry timezone information; PlainDate/PlainTime are timezone-agnostic
+3. **Range Operations**: First-class support for date and datetime ranges with proper inclusivity handling
+4. **Database Integration**: Seamless TypeORM integration with custom column types and query operators
+5. **Infinity Support**: Special handling for past/future infinity dates for unbounded ranges
+
+## Core Types
+
+### PlainDate
+
+A date without time or timezone information (e.g., "2025-01-15").
+
+```typescript
+// Create from various inputs
+const date1 = plainDate('2025-01-15')
+const date2 = plainDate(new Date())
+const date3 = plainDate({ year: 2025, month: Month.JANUARY, day: 15 })
+
+// Operations (immutable)
+const tomorrow = date1.add(1, 'day')
+const lastMonth = date1.subtract(1, 'month')
+const startOfYear = date1.startOf('year')
+
+// Comparisons
+date1.isSame(date2) // boolean
+date1.isAfter(date2) // boolean
+date1.isBefore(date2) // boolean
+date1.isToday() // boolean
+
+// Access components
+date1.year() // 2025
+date1.month() // Month enum
+date1.dayOfMonth() // 15
+
+// Formatting
+date1.format('YYYY-MM-DD') // "2025-01-15"
+date1.toString() // "2025-01-15"
+```
+
+### PlainTime
+
+Time without date or timezone (e.g., "14:30:00").
+
+```typescript
+// Create from various inputs
+const time1 = plainTime('14:30:00')
+const time2 = plainTime('14:30:00.500') // with milliseconds
+const time3 = plainTime({ hours: 14, minutes: 30, seconds: 0, milliseconds: 0 })
+const time4 = plainTime(new Date()) // extracts time component
+
+// Operations
+const later = time1.add(30, 'minutes')
+const earlier = time1.subtract(1, 'hour')
+
+// Comparisons
+time1.isSame(time2) // boolean
+time1.isAfter(time2) // boolean
+time1.isBefore(time2) // boolean
+
+// Access components (methods, not properties)
+time1.hours() // 14
+time1.minutes() // 30
+time1.seconds() // 0
+time1.milliseconds() // 0
+
+// Formatting
+time1.format('HH:mm:ss') // "14:30:00"
+```
+
+### Timestamp
+
+Date and time with timezone support.
+
+```typescript
+// Create
+const now = timestamp()
+const ts1 = timestamp('2025-01-15T14:30:00Z')
+const ts2 = timestamp(new Date())
+
+// Operations
+const later = ts1.add(2, 'hours')
+const earlier = ts1.subtract(1, 'day')
+
+// Timezone conversion
+const utc = ts1.setTimezone('UTC')
+const local = ts1.setTimezone('Europe/Brussels')
+
+// Extract components
+const date = ts1.toPlainDate()
+const time = ts1.toPlainTime()
+
+// Comparisons
+ts1.isBefore(ts2) // boolean
+ts1.isAfter(ts2) // boolean
+ts1.isSame(ts2, 'day') // boolean
+```
+
+### DateRange
+
+Inclusive or exclusive range between two dates.
+
+```typescript
+// Create ranges
+const range1 = new DateRange('2025-01-01', '2025-01-31') // [inclusive, inclusive]
+const range2 = new DateRange('2025-01-01', '2025-02-01', '[)') // [inclusive, exclusive)
+const range3 = new DateRange('2025-01-01', '2025-12-31', '()') // (exclusive, exclusive)
+
+// Range properties (getters)
+range1.days // number of days
+range1.weeks // number of weeks
+range1.months // number of months
+range1.quarters // number of quarters
+range1.years // number of years
+
+// Check containment
+range1.contains('2025-01-15') // true
+range1.contains('2025-02-01') // false
+
+// Range operations
+range1.overlaps(range2) // boolean - check if ranges overlap
+range1.overlap(range2) // returns overlapping DateRange (throws if no overlap)
+range1.diff(range2) // returns array of non-overlapping portions
+```
+
+### DateTimeRange
+
+Inclusive or exclusive range between two timestamps.
+
+```typescript
+// Create (default: [inclusive, exclusive))
+const range1 = new DateTimeRange('2025-01-01T00:00:00Z', '2025-01-02T00:00:00Z')
+const range2 = new DateTimeRange('2025-01-01', '2025-01-02', '[]') // fully inclusive
+const range3 = new DateTimeRange('2025-01-01', '2025-01-02', '()') // fully exclusive
+
+// Properties (getters)
+range1.years // whole years
+range1.months // whole months
+range1.weeks // whole weeks
+range1.days // whole days
+range1.hours // whole hours
+range1.minutes // whole minutes
+range1.seconds // whole seconds
+range1.milliseconds // whole milliseconds
+
+// Operations
+range1.contains(timestamp('2025-01-01T12:00:00Z')) // boolean
+range1.overlaps(range2) // boolean
+range1.overlap(range2) // returns overlapping DateTimeRange (throws if no overlap)
+range1.diff(range2) // returns MultiDateTimeRange of non-overlapping portions
+```
+
+## TypeORM Integration
+
+### Column Types
+
+```typescript
+@Entity()
+class Event {
+  @PlainDateColumn()
+  eventDate: PlainDate
+
+  @PlainTimeColumn()
+  startTime: PlainTime
+
+  @TimestampColumn()
+  createdAt: Timestamp
+
+  @DateRangeColumn()
+  validityPeriod: DateRange
+}
+```
+
+### Query Operators
+
+```typescript
+// Find events overlapping with a date range
+const events = await repository.find({
+  where: {
+    validityPeriod: overlapsWithDateRange(new DateRange('2025-01-01', '2025-12-31'))
+  }
+})
+
+// Find events on a specific date
+const todayEvents = await repository.find({
+  where: {
+    validityPeriod: containsPlainDate(plainDate())
+  }
+})
+```
+
+## Validation
+
+```typescript
+class CreateEventDto {
+  @IsPlainDate()
+  eventDate: PlainDate
+
+  @IsPlainTime()
+  startTime: PlainTime
+
+  @IsTimestamp()
+  createdAt: Timestamp
+
+  @IsDateRange()
+  validityPeriod: DateRange
+}
+```
+
+## NestJS Integration
+
+```typescript
+// DTO with ApiProperty decorators
+class EventFilterDto {
+  @ApiProperty({type: DateRangeDto})
+  @IsDateRange()
+  dateRange: DateRangeDto
+}
+
+// Command builder for input
+class CreateEventCommand {
+  @ApiProperty({type: DateTimeRangeDto})
+  @IsDateTimeRange()
+  timeRange: DateTimeRangeDto
+}
+```
+
+## Advanced Features
+
+### Infinity Dates
+
+```typescript
+import { futureInfinityDate, pastInfinityDate } from '@wisemen/datewise'
+
+const unboundedRange = new DateRange(pastInfinityDate(), futureInfinityDate())
+unboundedRange.contains(plainDate()) // always true
+```
+
+### RRule (Recurring Dates)
+
+```typescript
+
+const rrule = rrule({
+  frequency: Frequency.WEEKLY,
+  interval: 2,
+  ...
+})
+
+// Store in database with TypeORM
+@Entity()
+class RecurringEvent {
+  @RRuleColumn()
+  schedule: RRule
+}
+```
+
+## API Reference
+
+For detailed API documentation, see the TypeScript interfaces:
+- `PlainDate` - Date-only operations
+- `PlainTime` - Time-only operations  
+- `Timestamp` - Full datetime with timezone
+- `DateRange` - Date range operations
+- `DateTimeRange` - Datetime range operations
+- `MultiDateTimeRange` - Multiple ranges
+- `RRule` - Recurring patterns
+
+## License
+
+GPL
+
+## Author
+
+Wisemen

package/dist/common/constants.d.ts

@@ -0,0 +1,9 @@
+export declare const MILLIS_PER_SECOND = 1000;
+export declare const SECONDS_PER_MINUTE = 60;
+export declare const MINUTES_PER_HOUR = 60;
+export declare const DAYS_PER_WEEK = 7;
+export declare const HOURS_PER_DAY = 24;
+export declare const SECONDS_PER_HOUR: number;
+export declare const MILLIS_PER_HOUR: number;
+export declare const MILLIS_PER_WEEK: number;
+export declare const MILLIS_PER_MINUTE: number;

package/dist/common/constants.js

@@ -0,0 +1,10 @@
+export const MILLIS_PER_SECOND = 1000;
+export const SECONDS_PER_MINUTE = 60;
+export const MINUTES_PER_HOUR = 60;
+export const DAYS_PER_WEEK = 7;
+export const HOURS_PER_DAY = 24;
+export const SECONDS_PER_HOUR = SECONDS_PER_MINUTE * MINUTES_PER_HOUR;
+export const MILLIS_PER_HOUR = MINUTES_PER_HOUR * SECONDS_PER_MINUTE * MILLIS_PER_SECOND;
+export const MILLIS_PER_WEEK = DAYS_PER_WEEK * HOURS_PER_DAY * MILLIS_PER_HOUR;
+export const MILLIS_PER_MINUTE = MILLIS_PER_SECOND * SECONDS_PER_MINUTE;
+//# sourceMappingURL=constants.js.map

package/dist/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../lib/common/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAA;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAA;AACpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAClC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAA;AAC9B,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAA;AAC/B,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,gBAAgB,CAAA;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,iBAAiB,CAAA;AACxF,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,GAAG,aAAa,GAAG,eAAe,CAAA;AAC9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,kBAAkB,CAAA"}

package/dist/common/date-period.enum.d.ts

@@ -0,0 +1,7 @@
+import { ApiPropertyOptions } from '@nestjs/swagger';
+export declare enum DatePeriod {
+    PAST = "past",
+    ACTIVE = "active",
+    FUTURE = "future"
+}
+export declare function DatePeriodApiProperty(options?: ApiPropertyOptions): PropertyDecorator;

package/dist/common/date-period.enum.js

@@ -0,0 +1,15 @@
+import { ApiProperty } from '@nestjs/swagger';
+export var DatePeriod;
+(function (DatePeriod) {
+    DatePeriod["PAST"] = "past";
+    DatePeriod["ACTIVE"] = "active";
+    DatePeriod["FUTURE"] = "future";
+})(DatePeriod || (DatePeriod = {}));
+export function DatePeriodApiProperty(options) {
+    return ApiProperty({
+        ...options,
+        enum: DatePeriod,
+        enumName: 'DatePeriod'
+    });
+}
+//# sourceMappingURL=date-period.enum.js.map

package/dist/common/date-period.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-period.enum.js","sourceRoot":"","sources":["../../lib/common/date-period.enum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAsB,MAAM,iBAAiB,CAAA;AAEjE,MAAM,CAAN,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;AACnB,CAAC,EAJW,UAAU,KAAV,UAAU,QAIrB;AAED,MAAM,UAAU,qBAAqB,CACnC,OAA4B;IAE5B,OAAO,WAAW,CAAC;QACjB,GAAG,OAAO;QACV,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,YAAY;KACvB,CAAC,CAAA;AACJ,CAAC"}

package/dist/common/exhaustive-check.helper.d.ts

@@ -0,0 +1 @@
+export declare function exhaustiveCheck(_x: never): never;

package/dist/common/exhaustive-check.helper.js

@@ -0,0 +1,4 @@
+export function exhaustiveCheck(_x) {
+    throw new Error('This code should be unreachable');
+}
+//# sourceMappingURL=exhaustive-check.helper.js.map

package/dist/common/exhaustive-check.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exhaustive-check.helper.js","sourceRoot":"","sources":["../../lib/common/exhaustive-check.helper.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAE,EAAS;IACxC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;AACpD,CAAC"}

package/dist/common/inclusivity.d.ts

@@ -0,0 +1,8 @@
+export declare enum Inclusivity {
+    INCLUSIVE = 0,
+    EXCLUSIVE = 1
+}
+export type InclusivityString = '[]' | '()' | '[)' | '(]';
+export declare function mapToInclusivity(str: InclusivityString): [Inclusivity, Inclusivity];
+export declare function isInclusive(bound: Inclusivity): bound is Inclusivity.INCLUSIVE;
+export declare function intersect(firstBound: Inclusivity, secondBound: Inclusivity): Inclusivity;

package/dist/common/inclusivity.js

@@ -0,0 +1,23 @@
+export var Inclusivity;
+(function (Inclusivity) {
+    Inclusivity[Inclusivity["INCLUSIVE"] = 0] = "INCLUSIVE";
+    Inclusivity[Inclusivity["EXCLUSIVE"] = 1] = "EXCLUSIVE";
+})(Inclusivity || (Inclusivity = {}));
+export function mapToInclusivity(str) {
+    return [
+        str[0] === '[' ? Inclusivity.INCLUSIVE : Inclusivity.EXCLUSIVE,
+        str[1] === ']' ? Inclusivity.INCLUSIVE : Inclusivity.EXCLUSIVE
+    ];
+}
+export function isInclusive(bound) {
+    return bound === Inclusivity.INCLUSIVE;
+}
+export function intersect(firstBound, secondBound) {
+    if (isInclusive(firstBound) && isInclusive(secondBound)) {
+        return Inclusivity.INCLUSIVE;
+    }
+    else {
+        return Inclusivity.EXCLUSIVE;
+    }
+}
+//# sourceMappingURL=inclusivity.js.map

package/dist/common/inclusivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inclusivity.js","sourceRoot":"","sources":["../../lib/common/inclusivity.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,uDAAa,CAAA;IACb,uDAAa,CAAA;AACf,CAAC,EAHW,WAAW,KAAX,WAAW,QAGtB;AAID,MAAM,UAAU,gBAAgB,CAAE,GAAsB;IACtD,OAAO;QACL,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS;QAC9D,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS;KAC/D,CAAA;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAE,KAAkB;IAC7C,OAAO,KAAK,KAAK,WAAW,CAAC,SAAS,CAAA;AACxC,CAAC;AAED,MAAM,UAAU,SAAS,CAAE,UAAuB,EAAE,WAAwB;IAC1E,IAAI,WAAW,CAAC,UAAU,CAAC,IAAI,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;QACxD,OAAO,WAAW,CAAC,SAAS,CAAA;IAC9B,CAAC;SAAM,CAAC;QACN,OAAO,WAAW,CAAC,SAAS,CAAA;IAC9B,CAAC;AACH,CAAC"}

package/dist/common/index.d.ts

@@ -0,0 +1,4 @@
+export * from './month.js';
+export * from './timezone.js';
+export * from './date-period.enum.js';
+export * from './typeorm/index.js';

package/dist/common/index.js

@@ -0,0 +1,5 @@
+export * from './month.js';
+export * from './timezone.js';
+export * from './date-period.enum.js';
+export * from './typeorm/index.js';
+//# sourceMappingURL=index.js.map

package/dist/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA"}

package/dist/common/init-dayjs.d.ts

@@ -0,0 +1 @@
+export declare function initDayjs(): void;

package/dist/common/init-dayjs.js

@@ -0,0 +1,31 @@
+import dayjs from 'dayjs';
+import customParseFormat from 'dayjs/plugin/customParseFormat.js';
+import isoWeek from 'dayjs/plugin/isoWeek.js';
+import MinMax from 'dayjs/plugin/minMax.js';
+import Utc from 'dayjs/plugin/utc.js';
+import TimeZone from 'dayjs/plugin/timezone.js';
+import weekOfYear from 'dayjs/plugin/weekOfYear.js';
+import dayOfYear from 'dayjs/plugin/dayOfYear.js';
+import isToday from 'dayjs/plugin/isToday.js';
+import isTomorrow from 'dayjs/plugin/isTomorrow.js';
+import isYesterday from 'dayjs/plugin/isYesterday.js';
+import isBetween from 'dayjs/plugin/isBetween.js';
+import isSameOrBefore from 'dayjs/plugin/isSameOrBefore.js';
+import isSameOrAfter from 'dayjs/plugin/isSameOrAfter.js';
+export function initDayjs() {
+    dayjs.extend(customParseFormat);
+    dayjs.extend(isoWeek);
+    dayjs.extend(MinMax);
+    dayjs.extend(Utc);
+    dayjs.extend(TimeZone);
+    dayjs.extend(weekOfYear);
+    dayjs.extend(dayOfYear);
+    dayjs.extend(isToday);
+    dayjs.extend(isTomorrow);
+    dayjs.extend(isYesterday);
+    dayjs.extend(isBetween);
+    dayjs.extend(isSameOrBefore);
+    dayjs.extend(isSameOrAfter);
+    dayjs.tz.setDefault('UTC');
+}
+//# sourceMappingURL=init-dayjs.js.map

package/dist/common/init-dayjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-dayjs.js","sourceRoot":"","sources":["../../lib/common/init-dayjs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,iBAAiB,MAAM,mCAAmC,CAAA;AACjE,OAAO,OAAO,MAAM,yBAAyB,CAAA;AAC7C,OAAO,MAAM,MAAM,wBAAwB,CAAA;AAC3C,OAAO,GAAG,MAAM,qBAAqB,CAAA;AACrC,OAAO,QAAQ,MAAM,0BAA0B,CAAA;AAC/C,OAAO,UAAU,MAAM,4BAA4B,CAAA;AACnD,OAAO,SAAS,MAAM,2BAA2B,CAAA;AACjD,OAAO,OAAO,MAAM,yBAAyB,CAAA;AAC7C,OAAO,UAAU,MAAM,4BAA4B,CAAA;AACnD,OAAO,WAAW,MAAM,6BAA6B,CAAA;AACrD,OAAO,SAAS,MAAM,2BAA2B,CAAA;AACjD,OAAO,cAAc,MAAM,gCAAgC,CAAA;AAC3D,OAAO,aAAa,MAAM,+BAA+B,CAAA;AAEzD,MAAM,UAAU,SAAS;IACvB,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAA;IAC/B,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACrB,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACpB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACjB,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACtB,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACxB,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACvB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACrB,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACxB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IACzB,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACvB,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;IAC5B,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;IAC3B,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;AAC5B,CAAC"}

package/dist/common/month.d.ts

@@ -0,0 +1,15 @@
+export declare enum Month {
+    JANUARY = 1,
+    FEBRUARY = 2,
+    MARCH = 3,
+    APRIL = 4,
+    MAY = 5,
+    JUNE = 6,
+    JULY = 7,
+    AUGUST = 8,
+    SEPTEMBER = 9,
+    OCTOBER = 10,
+    NOVEMBER = 11,
+    DECEMBER = 12
+}
+export declare function month(value: number): Month;

package/dist/common/month.js

@@ -0,0 +1,21 @@
+export var Month;
+(function (Month) {
+    Month[Month["JANUARY"] = 1] = "JANUARY";
+    Month[Month["FEBRUARY"] = 2] = "FEBRUARY";
+    Month[Month["MARCH"] = 3] = "MARCH";
+    Month[Month["APRIL"] = 4] = "APRIL";
+    Month[Month["MAY"] = 5] = "MAY";
+    Month[Month["JUNE"] = 6] = "JUNE";
+    Month[Month["JULY"] = 7] = "JULY";
+    Month[Month["AUGUST"] = 8] = "AUGUST";
+    Month[Month["SEPTEMBER"] = 9] = "SEPTEMBER";
+    Month[Month["OCTOBER"] = 10] = "OCTOBER";
+    Month[Month["NOVEMBER"] = 11] = "NOVEMBER";
+    Month[Month["DECEMBER"] = 12] = "DECEMBER";
+})(Month || (Month = {}));
+export function month(value) {
+    if (1 <= value && value <= 12)
+        return value;
+    throw new Error('Month must be a value between 1 and 12');
+}
+//# sourceMappingURL=month.js.map

package/dist/common/month.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"month.js","sourceRoot":"","sources":["../../lib/common/month.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,KAaX;AAbD,WAAY,KAAK;IACf,uCAAW,CAAA;IACX,yCAAY,CAAA;IACZ,mCAAS,CAAA;IACT,mCAAS,CAAA;IACT,+BAAO,CAAA;IACP,iCAAQ,CAAA;IACR,iCAAQ,CAAA;IACR,qCAAU,CAAA;IACV,2CAAa,CAAA;IACb,wCAAY,CAAA;IACZ,0CAAa,CAAA;IACb,0CAAa,CAAA;AACf,CAAC,EAbW,KAAK,KAAL,KAAK,QAahB;AAED,MAAM,UAAU,KAAK,CAAE,KAAa;IAClC,IAAI,CAAC,IAAI,KAAK,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,KAAc,CAAA;IACpD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;AAC3D,CAAC"}