@naturalcycles/js-lib 14.100.0 → 14.101.0

package/dist/datetime/localDate.d.ts

@@ -1,4 +1,4 @@
-import { IsoDateString, IsoDateTimeString, UnixTimestampNumber } from '../types';
+import { IsoDateString, IsoDateTimeString, UnixTimestampMillisNumber, UnixTimestampNumber } from '../types';
 import { LocalTime } from './localTime';
 export declare type LocalDateUnit = LocalDateUnitStrict | 'week';
 export declare type LocalDateUnitStrict = 'year' | 'month' | 'day';
@@ -89,7 +89,7 @@ export declare class LocalDate {
     toString(): IsoDateString;
     toStringCompact(): string;
     unix(): UnixTimestampNumber;
-    unixMillis(): number;
+    unixMillis(): UnixTimestampMillisNumber;
     toJSON(): IsoDateString;
     format(fmt: LocalDateFormatter): string;
 }

package/dist/datetime/localTime.d.ts

@@ -1,4 +1,4 @@
-import { IsoDateString, IsoDateTimeString, UnixTimestampNumber } from '../types';
+import { IsoDateString, IsoDateTimeString, UnixTimestampMillisNumber, UnixTimestampNumber } from '../types';
 import { Inclusiveness, LocalDate } from './localDate';
 export declare type LocalTimeUnit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second';
 export declare enum ISODayOfWeek {
@@ -34,7 +34,7 @@ export declare class LocalTime {
     /**
      * Create LocalTime from unixTimestamp in milliseconds (not in seconds).
      */
-    static ofMillis(millis: number): LocalTime;
+    static ofMillis(millis: UnixTimestampMillisNumber): LocalTime;
     /**
      * Returns null if invalid
      */
@@ -97,7 +97,7 @@ export declare class LocalTime {
     getDate(): Date;
     clone(): LocalTime;
     unix(): UnixTimestampNumber;
-    unixMillis(): number;
+    unixMillis(): UnixTimestampMillisNumber;
     valueOf(): UnixTimestampNumber;
     toLocalDate(): LocalDate;
     toPretty(seconds?: boolean): IsoDateTimeString;

package/dist/index.d.ts

@@ -51,7 +51,7 @@ export * from './string/string.util';
 import { JsonStringifyFunction, StringifyAnyOptions, _stringifyAny } from './string/stringifyAny';
 export * from './time/time.util';
 import { Class, ConditionalExcept, ConditionalPick, Merge, Promisable, ReadonlyDeep, Simplify } from './typeFest';
-import { AsyncMapper, AsyncPredicate, BaseDBEntity, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, Saved, Unsaved, UnsavedId, BatchResult, InstanceId, IsoDate, IsoDateString, IsoDateTimeString, KeyValueTuple, Mapper, ObjectMapper, ObjectPredicate, Predicate, PromiseMap, AnyObject, AnyFunction, Reviver, SavedDBEntity, StringMap, UnixTimestampNumber, UnixTimestamp, Integer, ValueOf, ValuesOf, AbortableMapper, AbortableAsyncPredicate, AbortableAsyncMapper, AbortablePredicate, END, SKIP, _noop, _objectKeys, _passNothingPredicate, _passthroughMapper, _passthroughPredicate, _passUndefinedMapper, _stringMapEntries, _stringMapValues } from './types';
+import { AsyncMapper, AsyncPredicate, BaseDBEntity, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, Saved, Unsaved, UnsavedId, BatchResult, InstanceId, IsoDate, IsoDateString, IsoDateTimeString, KeyValueTuple, Mapper, ObjectMapper, ObjectPredicate, Predicate, PromiseMap, AnyObject, AnyFunction, Reviver, SavedDBEntity, StringMap, UnixTimestampNumber, UnixTimestampMillisNumber, UnixTimestamp, Integer, ValueOf, ValuesOf, AbortableMapper, AbortableAsyncPredicate, AbortableAsyncMapper, AbortablePredicate, END, SKIP, _noop, _objectKeys, _passNothingPredicate, _passthroughMapper, _passthroughPredicate, _passUndefinedMapper, _stringMapEntries, _stringMapValues } from './types';
 export * from './unit/size.util';
 import { is } from './vendor/is';
 import { CommonLogLevel, CommonLogFunction, CommonLogger, commonLoggerMinLevel, commonLoggerNoop, commonLogLevelNumber, commonLoggerPipe, commonLoggerPrefix, CommonLogWithLevelFunction, commonLoggerCreate } from './log/commonLogger';
@@ -68,5 +68,5 @@ import { LocalDateConfig, LocalDateFormatter, LocalDateUnit, LocalDateUnitStrict
 import { LocalTimeConfig, LocalTimeFormatter, LocalTimeUnit, LocalTimeComponents, ISODayOfWeek } from './datetime/localTime';
 import { DateIntervalConfig, DateIntervalString } from './datetime/dateInterval';
 import { TimeIntervalConfig, TimeIntervalString } from './datetime/timeInterval';
-export type { DateIntervalConfig, DateIntervalString, TimeIntervalConfig, TimeIntervalString, LocalDateConfig, LocalDateFormatter, LocalDateUnit, LocalDateUnitStrict, Inclusiveness, LocalTimeConfig, LocalTimeFormatter, LocalTimeUnit, ISODayOfWeek, 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, IsoDateString, IsoDateTimeString, Reviver, PMapOptions, Mapper, AsyncMapper, Predicate, AsyncPredicate, BatchResult, DeferredPromise, PRetryOptions, PTimeoutOptions, TryCatchOptions, StringifyAnyOptions, JsonStringifyFunction, Merge, ReadonlyDeep, Promisable, Simplify, ConditionalPick, ConditionalExcept, Class, UnixTimestampNumber, UnixTimestamp, Integer, BaseDBEntity, SavedDBEntity, Saved, Unsaved, UnsavedId, 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 type { DateIntervalConfig, DateIntervalString, TimeIntervalConfig, TimeIntervalString, LocalDateConfig, LocalDateFormatter, LocalDateUnit, LocalDateUnitStrict, Inclusiveness, LocalTimeConfig, LocalTimeFormatter, LocalTimeUnit, ISODayOfWeek, 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, IsoDateString, IsoDateTimeString, Reviver, PMapOptions, Mapper, AsyncMapper, Predicate, AsyncPredicate, BatchResult, DeferredPromise, PRetryOptions, PTimeoutOptions, TryCatchOptions, StringifyAnyOptions, JsonStringifyFunction, Merge, ReadonlyDeep, Promisable, Simplify, ConditionalPick, ConditionalExcept, Class, UnixTimestampNumber, UnixTimestampMillisNumber, UnixTimestamp, Integer, BaseDBEntity, SavedDBEntity, Saved, Unsaved, UnsavedId, 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/types.d.ts

@@ -154,6 +154,12 @@ export declare type IsoDateTimeString = string;
  * @example 1628945450
  */
 export declare type UnixTimestampNumber = number;
+/**
+ * Interface explicitly states that the value is a "Unix timestamp in **milleseconds**" (not seconds)
+ *
+ * @example 1628945450000
+ */
+export declare type UnixTimestampMillisNumber = number;
 /**
  * @deprecated use UnixTimestampNumber
  */

package/package.json

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

package/src/datetime/localDate.ts

@@ -1,5 +1,10 @@
 import { _assert } from '../error/assert'
-import { IsoDateString, IsoDateTimeString, UnixTimestampNumber } from '../types'
+import {
+  IsoDateString,
+  IsoDateTimeString,
+  UnixTimestampMillisNumber,
+  UnixTimestampNumber,
+} from '../types'
 import { LocalTime } from './localTime'
 
 export type LocalDateUnit = LocalDateUnitStrict | 'week'
@@ -477,7 +482,7 @@ export class LocalDate {
     return Math.floor(this.toDate().valueOf() / 1000)
   }
 
-  unixMillis(): number {
+  unixMillis(): UnixTimestampMillisNumber {
     return this.toDate().valueOf()
   }
 

package/src/datetime/localTime.ts

@@ -1,6 +1,11 @@
 import { _assert } from '../error/assert'
 import { _ms } from '../time/time.util'
-import { IsoDateString, IsoDateTimeString, UnixTimestampNumber } from '../types'
+import {
+  IsoDateString,
+  IsoDateTimeString,
+  UnixTimestampMillisNumber,
+  UnixTimestampNumber,
+} from '../types'
 import { Inclusiveness, LocalDate } from './localDate'
 
 export type LocalTimeUnit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second'
@@ -59,7 +64,7 @@ export class LocalTime {
   /**
    * Create LocalTime from unixTimestamp in milliseconds (not in seconds).
    */
-  static ofMillis(millis: number): LocalTime {
+  static ofMillis(millis: UnixTimestampMillisNumber): LocalTime {
     return LocalTime.of(new Date(millis))
   }
 
@@ -478,7 +483,7 @@ export class LocalTime {
     return Math.floor(this.$date.valueOf() / 1000)
   }
 
-  unixMillis(): number {
+  unixMillis(): UnixTimestampMillisNumber {
     return this.$date.valueOf()
   }
 

package/src/index.ts

@@ -120,6 +120,7 @@ import {
   SavedDBEntity,
   StringMap,
   UnixTimestampNumber,
+  UnixTimestampMillisNumber,
   UnixTimestamp,
   Integer,
   ValueOf,
@@ -243,6 +244,7 @@ export type {
   ConditionalExcept,
   Class,
   UnixTimestampNumber,
+  UnixTimestampMillisNumber,
   UnixTimestamp,
   Integer,
   BaseDBEntity,

package/src/types.ts

@@ -213,6 +213,13 @@ export type IsoDateTimeString = string
  */
 export type UnixTimestampNumber = number
 
+/**
+ * Interface explicitly states that the value is a "Unix timestamp in **milleseconds**" (not seconds)
+ *
+ * @example 1628945450000
+ */
+export type UnixTimestampMillisNumber = number
+
 /**
  * @deprecated use UnixTimestampNumber
  */