@naturalcycles/js-lib 14.92.0 → 14.93.0

package/dist/datetime/dateInterval.d.ts

@@ -0,0 +1,29 @@
+import { LocalDate, LocalDateConfig } from './localDate';
+export declare type DateIntervalConfig = DateInterval | string;
+/**
+ * Class that supports ISO8601 "Time interval" standard that looks like `2022-02-24/2022-03-30`.
+ *
+ * @experimental
+ */
+export declare class DateInterval {
+    start: LocalDate;
+    end: LocalDate;
+    private constructor();
+    static of(start: LocalDateConfig, end: LocalDateConfig): DateInterval;
+    /**
+     * Parses string like `2022-02-24/2023-03-30` into a DateInterval.
+     */
+    static parse(d: DateIntervalConfig): DateInterval;
+    isSame(d: DateIntervalConfig): boolean;
+    isBefore(d: DateIntervalConfig): boolean;
+    isSameOrBefore(d: DateIntervalConfig): boolean;
+    isAfter(d: DateIntervalConfig): boolean;
+    isSameOrAfter(d: DateIntervalConfig): boolean;
+    /**
+     * DateIntervals compare by start date.
+     * If it's the same - then by end date.
+     */
+    cmp(d: DateIntervalConfig): -1 | 0 | 1;
+    toString(): string;
+    private toJSON;
+}

package/dist/datetime/dateInterval.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DateInterval = void 0;
+const localDate_1 = require("./localDate");
+/**
+ * Class that supports ISO8601 "Time interval" standard that looks like `2022-02-24/2022-03-30`.
+ *
+ * @experimental
+ */
+class DateInterval {
+    constructor(start, end) {
+        this.start = start;
+        this.end = end;
+    }
+    static of(start, end) {
+        return new DateInterval(localDate_1.LocalDate.of(start), localDate_1.LocalDate.of(end));
+    }
+    /**
+     * Parses string like `2022-02-24/2023-03-30` into a DateInterval.
+     */
+    static parse(d) {
+        if (d instanceof DateInterval)
+            return d;
+        const [start, end] = d.split('/');
+        if (!end || !start) {
+            throw new Error(`Cannot parse "${d}" into DateInterval`);
+        }
+        return new DateInterval(localDate_1.LocalDate.of(start), localDate_1.LocalDate.of(end));
+    }
+    isSame(d) {
+        return this.cmp(d) === 0;
+    }
+    isBefore(d) {
+        return this.cmp(d) === -1;
+    }
+    isSameOrBefore(d) {
+        return this.cmp(d) <= 0;
+    }
+    isAfter(d) {
+        return this.cmp(d) === 1;
+    }
+    isSameOrAfter(d) {
+        return this.cmp(d) >= 0;
+    }
+    /**
+     * DateIntervals compare by start date.
+     * If it's the same - then by end date.
+     */
+    cmp(d) {
+        d = DateInterval.parse(d);
+        return this.start.cmp(d.start) || this.end.cmp(d.end);
+    }
+    toString() {
+        return [this.start, this.end].join('/');
+    }
+    toJSON() {
+        return this.toString();
+    }
+}
+exports.DateInterval = DateInterval;

package/dist/datetime/localTime.js

@@ -14,6 +14,9 @@ const localDate_1 = require("./localDate");
 // .valueOf returns unix timestamp (no millis)
 // Prevents dayjs(undefined) being dayjs.now()
 // Validates on parse, throws if invalid. Doesn't allow invalid objects
+// No arbitrary .format('') (which is slow to parse) vs well-defined (opinionated) formats
+// Separate LocalTime, powered by native js Date, and LocalDate - a smaller functionality class when
+// you only need "whole dates", no time, no timezone worry
 /**
  * @experimental
  */

package/dist/index.d.ts

@@ -63,7 +63,9 @@ export * from './math/stack.util';
 export * from './string/leven';
 export * from './datetime/localDate';
 export * from './datetime/localTime';
+export * from './datetime/dateInterval';
 import { LocalDateConfig, LocalDateUnit } from './datetime/localDate';
 import { LocalTimeConfig, LocalTimeUnit, LocalTimeComponents } from './datetime/localTime';
-export type { LocalDateConfig, LocalDateUnit, LocalTimeConfig, LocalTimeUnit, LocalTimeComponents, AbortableMapper, AbortablePredicate, AbortableAsyncPredicate, AbortableAsyncMapper, PQueueCfg, MemoCache, AsyncMemoCache, PromiseDecoratorCfg, PromiseDecoratorResp, ErrorData, ErrorObject, HttpErrorData, HttpErrorResponse, Admin401ErrorData, Admin403ErrorData, StringMap, PromiseMap, AnyObject, AnyFunction, ValuesOf, ValueOf, KeyValueTuple, ObjectMapper, ObjectPredicate, InstanceId, IsoDate, IsoDateTime, Reviver, PMapOptions, Mapper, AsyncMapper, Predicate, AsyncPredicate, BatchResult, DeferredPromise, PRetryOptions, PTimeoutOptions, TryCatchOptions, StringifyAnyOptions, JsonStringifyFunction, Merge, ReadonlyDeep, Promisable, Simplify, ConditionalPick, ConditionalExcept, Class, UnixTimestamp, Integer, BaseDBEntity, SavedDBEntity, Saved, Unsaved, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, JsonSchema, JsonSchemaAny, JsonSchemaOneOf, JsonSchemaAllOf, JsonSchemaAnyOf, JsonSchemaNot, JsonSchemaRef, JsonSchemaConst, JsonSchemaEnum, JsonSchemaString, JsonSchemaNumber, JsonSchemaBoolean, JsonSchemaNull, JsonSchemaRootObject, JsonSchemaObject, JsonSchemaArray, JsonSchemaTuple, JsonSchemaBuilder, CommonLogLevel, CommonLogWithLevelFunction, CommonLogFunction, CommonLogger, };
+import { DateIntervalConfig } from './datetime/dateInterval';
+export type { DateIntervalConfig, LocalDateConfig, LocalDateUnit, LocalTimeConfig, LocalTimeUnit, LocalTimeComponents, AbortableMapper, AbortablePredicate, AbortableAsyncPredicate, AbortableAsyncMapper, PQueueCfg, MemoCache, AsyncMemoCache, PromiseDecoratorCfg, PromiseDecoratorResp, ErrorData, ErrorObject, HttpErrorData, HttpErrorResponse, Admin401ErrorData, Admin403ErrorData, StringMap, PromiseMap, AnyObject, AnyFunction, ValuesOf, ValueOf, KeyValueTuple, ObjectMapper, ObjectPredicate, InstanceId, IsoDate, IsoDateTime, Reviver, PMapOptions, Mapper, AsyncMapper, Predicate, AsyncPredicate, BatchResult, DeferredPromise, PRetryOptions, PTimeoutOptions, TryCatchOptions, StringifyAnyOptions, JsonStringifyFunction, Merge, ReadonlyDeep, Promisable, Simplify, ConditionalPick, ConditionalExcept, Class, UnixTimestamp, Integer, BaseDBEntity, SavedDBEntity, Saved, Unsaved, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, JsonSchema, JsonSchemaAny, JsonSchemaOneOf, JsonSchemaAllOf, JsonSchemaAnyOf, JsonSchemaNot, JsonSchemaRef, JsonSchemaConst, JsonSchemaEnum, JsonSchemaString, JsonSchemaNumber, JsonSchemaBoolean, JsonSchemaNull, JsonSchemaRootObject, JsonSchemaObject, JsonSchemaArray, JsonSchemaTuple, JsonSchemaBuilder, CommonLogLevel, CommonLogWithLevelFunction, CommonLogFunction, CommonLogger, };
 export { is, _createPromiseDecorator, _stringMapValues, _stringMapEntries, _objectKeys, pMap, _passthroughMapper, _passUndefinedMapper, _passthroughPredicate, _passNothingPredicate, _noop, ErrorMode, pDefer, AggregatedError, pRetry, pRetryFn, pTimeout, pTimeoutFn, _tryCatch, _TryCatch, _stringifyAny, jsonSchema, JsonSchemaAnyBuilder, commonLoggerMinLevel, commonLoggerNoop, commonLogLevelNumber, commonLoggerPipe, commonLoggerPrefix, commonLoggerCreate, PQueue, END, SKIP, };

package/dist/index.js

@@ -95,3 +95,4 @@ tslib_1.__exportStar(require("./math/stack.util"), exports);
 tslib_1.__exportStar(require("./string/leven"), exports);
 tslib_1.__exportStar(require("./datetime/localDate"), exports);
 tslib_1.__exportStar(require("./datetime/localTime"), exports);
+tslib_1.__exportStar(require("./datetime/dateInterval"), exports);

package/dist-esm/datetime/dateInterval.js

@@ -0,0 +1,56 @@
+import { LocalDate } from './localDate';
+/**
+ * Class that supports ISO8601 "Time interval" standard that looks like `2022-02-24/2022-03-30`.
+ *
+ * @experimental
+ */
+export class DateInterval {
+    constructor(start, end) {
+        this.start = start;
+        this.end = end;
+    }
+    static of(start, end) {
+        return new DateInterval(LocalDate.of(start), LocalDate.of(end));
+    }
+    /**
+     * Parses string like `2022-02-24/2023-03-30` into a DateInterval.
+     */
+    static parse(d) {
+        if (d instanceof DateInterval)
+            return d;
+        const [start, end] = d.split('/');
+        if (!end || !start) {
+            throw new Error(`Cannot parse "${d}" into DateInterval`);
+        }
+        return new DateInterval(LocalDate.of(start), LocalDate.of(end));
+    }
+    isSame(d) {
+        return this.cmp(d) === 0;
+    }
+    isBefore(d) {
+        return this.cmp(d) === -1;
+    }
+    isSameOrBefore(d) {
+        return this.cmp(d) <= 0;
+    }
+    isAfter(d) {
+        return this.cmp(d) === 1;
+    }
+    isSameOrAfter(d) {
+        return this.cmp(d) >= 0;
+    }
+    /**
+     * DateIntervals compare by start date.
+     * If it's the same - then by end date.
+     */
+    cmp(d) {
+        d = DateInterval.parse(d);
+        return this.start.cmp(d.start) || this.end.cmp(d.end);
+    }
+    toString() {
+        return [this.start, this.end].join('/');
+    }
+    toJSON() {
+        return this.toString();
+    }
+}

package/dist-esm/datetime/localTime.js

@@ -11,6 +11,9 @@ import { LocalDate } from './localDate';
 // .valueOf returns unix timestamp (no millis)
 // Prevents dayjs(undefined) being dayjs.now()
 // Validates on parse, throws if invalid. Doesn't allow invalid objects
+// No arbitrary .format('') (which is slow to parse) vs well-defined (opinionated) formats
+// Separate LocalTime, powered by native js Date, and LocalDate - a smaller functionality class when
+// you only need "whole dates", no time, no timezone worry
 /**
  * @experimental
  */

package/dist-esm/index.js

@@ -59,4 +59,5 @@ export * from './math/stack.util';
 export * from './string/leven';
 export * from './datetime/localDate';
 export * from './datetime/localTime';
+export * from './datetime/dateInterval';
 export { is, _createPromiseDecorator, _stringMapValues, _stringMapEntries, _objectKeys, pMap, _passthroughMapper, _passUndefinedMapper, _passthroughPredicate, _passNothingPredicate, _noop, ErrorMode, pDefer, AggregatedError, pRetry, pRetryFn, pTimeout, pTimeoutFn, _tryCatch, _TryCatch, _stringifyAny, jsonSchema, JsonSchemaAnyBuilder, commonLoggerMinLevel, commonLoggerNoop, commonLogLevelNumber, commonLoggerPipe, commonLoggerPrefix, commonLoggerCreate, PQueue, END, SKIP, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.92.0",
+  "version": "14.93.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",

package/src/datetime/dateInterval.ts

@@ -0,0 +1,68 @@
+import { LocalDate, LocalDateConfig } from './localDate'
+
+export type DateIntervalConfig = DateInterval | string
+
+/**
+ * Class that supports ISO8601 "Time interval" standard that looks like `2022-02-24/2022-03-30`.
+ *
+ * @experimental
+ */
+export class DateInterval {
+  private constructor(public start: LocalDate, public end: LocalDate) {}
+
+  static of(start: LocalDateConfig, end: LocalDateConfig): DateInterval {
+    return new DateInterval(LocalDate.of(start), LocalDate.of(end))
+  }
+
+  /**
+   * Parses string like `2022-02-24/2023-03-30` into a DateInterval.
+   */
+  static parse(d: DateIntervalConfig): DateInterval {
+    if (d instanceof DateInterval) return d
+
+    const [start, end] = d.split('/')
+
+    if (!end || !start) {
+      throw new Error(`Cannot parse "${d}" into DateInterval`)
+    }
+
+    return new DateInterval(LocalDate.of(start), LocalDate.of(end))
+  }
+
+  isSame(d: DateIntervalConfig): boolean {
+    return this.cmp(d) === 0
+  }
+
+  isBefore(d: DateIntervalConfig): boolean {
+    return this.cmp(d) === -1
+  }
+
+  isSameOrBefore(d: DateIntervalConfig): boolean {
+    return this.cmp(d) <= 0
+  }
+
+  isAfter(d: DateIntervalConfig): boolean {
+    return this.cmp(d) === 1
+  }
+
+  isSameOrAfter(d: DateIntervalConfig): boolean {
+    return this.cmp(d) >= 0
+  }
+
+  /**
+   * DateIntervals compare by start date.
+   * If it's the same - then by end date.
+   */
+  cmp(d: DateIntervalConfig): -1 | 0 | 1 {
+    d = DateInterval.parse(d)
+    return this.start.cmp(d.start) || this.end.cmp(d.end)
+  }
+
+  toString(): string {
+    return [this.start, this.end].join('/')
+  }
+
+  private toJSON(): string {
+    return this.toString()
+  }
+}

package/src/datetime/localTime.ts

@@ -27,6 +27,9 @@ export interface LocalTimeComponents {
 // .valueOf returns unix timestamp (no millis)
 // Prevents dayjs(undefined) being dayjs.now()
 // Validates on parse, throws if invalid. Doesn't allow invalid objects
+// No arbitrary .format('') (which is slow to parse) vs well-defined (opinionated) formats
+// Separate LocalTime, powered by native js Date, and LocalDate - a smaller functionality class when
+// you only need "whole dates", no time, no timezone worry
 /**
  * @experimental
  */

package/src/index.ts

@@ -158,10 +158,13 @@ export * from './math/stack.util'
 export * from './string/leven'
 export * from './datetime/localDate'
 export * from './datetime/localTime'
+export * from './datetime/dateInterval'
 import { LocalDateConfig, LocalDateUnit } from './datetime/localDate'
 import { LocalTimeConfig, LocalTimeUnit, LocalTimeComponents } from './datetime/localTime'
+import { DateIntervalConfig } from './datetime/dateInterval'
 
 export type {
+  DateIntervalConfig,
   LocalDateConfig,
   LocalDateUnit,
   LocalTimeConfig,