@naturalcycles/js-lib 14.99.4 → 14.102.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 {
@@ -31,6 +31,10 @@ export declare class LocalTime {
      * Input can already be a LocalDate - it is returned as-is in that case.
      */
     static of(d: LocalTimeConfig): LocalTime;
+    /**
+     * Create LocalTime from unixTimestamp in milliseconds (not in seconds).
+     */
+    static ofMillis(millis: UnixTimestampMillisNumber): LocalTime;
     /**
      * Returns null if invalid
      */
@@ -93,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/datetime/localTime.js

@@ -39,6 +39,12 @@ class LocalTime {
         }
         return t;
     }
+    /**
+     * Create LocalTime from unixTimestamp in milliseconds (not in seconds).
+     */
+    static ofMillis(millis) {
+        return LocalTime.of(new Date(millis));
+    }
     /**
      * Returns null if invalid
      */

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/json-schema/jsonSchemaBuilder.d.ts

@@ -19,6 +19,7 @@ export declare const jsonSchema: {
     number(): JsonSchemaNumberBuilder;
     integer(): JsonSchemaNumberBuilder;
     unixTimestamp(): JsonSchemaNumberBuilder;
+    unixTimestamp2000(): JsonSchemaNumberBuilder;
     string(): JsonSchemaStringBuilder;
     dateString(): JsonSchemaStringBuilder;
     object<T_4 extends AnyObject>(props: { [k in keyof T_4]: JsonSchemaAnyBuilder<T_4[k], JsonSchema<T_4[k]>>; }): JsonSchemaObjectBuilder<T_4>;
@@ -72,7 +73,9 @@ export declare class JsonSchemaNumberBuilder extends JsonSchemaAnyBuilder<number
     float: () => this;
     double: () => this;
     unixTimestamp: () => this;
+    unixTimestamp2000: () => this;
     unixTimestampMillis: () => this;
+    unixTimestampMillis2000: () => this;
     utcOffset: () => this;
     utcOffsetHours: () => this;
 }

package/dist/json-schema/jsonSchemaBuilder.js

@@ -50,6 +50,9 @@ exports.jsonSchema = {
     unixTimestamp() {
         return new JsonSchemaNumberBuilder().unixTimestamp();
     },
+    unixTimestamp2000() {
+        return new JsonSchemaNumberBuilder().unixTimestamp2000();
+    },
     // string types
     string() {
         return new JsonSchemaStringBuilder();
@@ -167,7 +170,9 @@ class JsonSchemaNumberBuilder extends JsonSchemaAnyBuilder {
         this.float = () => this.format('float');
         this.double = () => this.format('double');
         this.unixTimestamp = () => this.format('unixTimestamp');
+        this.unixTimestamp2000 = () => this.format('unixTimestamp2000');
         this.unixTimestampMillis = () => this.format('unixTimestampMillis');
+        this.unixTimestampMillis2000 = () => this.format('unixTimestampMillis2000');
         this.utcOffset = () => this.format('utcOffset');
         this.utcOffsetHours = () => this.format('utcOffsetHours');
     }
@@ -309,8 +314,8 @@ class JsonSchemaObjectBuilder extends JsonSchemaAnyBuilder {
     baseDBEntity(idType = 'string') {
         Object.assign(this.schema.properties, {
             id: { type: idType },
-            created: { type: 'number', format: 'unixTimestamp' },
-            updated: { type: 'number', format: 'unixTimestamp' },
+            created: { type: 'number', format: 'unixTimestamp2000' },
+            updated: { type: 'number', format: 'unixTimestamp2000' },
         });
         return this;
     }

package/dist/json-schema/jsonSchemas.js

@@ -4,11 +4,11 @@ exports.savedDBEntityJsonSchema = exports.baseDBEntityJsonSchema = void 0;
 const jsonSchemaBuilder_1 = require("./jsonSchemaBuilder");
 exports.baseDBEntityJsonSchema = jsonSchemaBuilder_1.jsonSchema.object({
     id: jsonSchemaBuilder_1.jsonSchema.string().optional(),
-    created: jsonSchemaBuilder_1.jsonSchema.unixTimestamp().optional(),
-    updated: jsonSchemaBuilder_1.jsonSchema.unixTimestamp().optional(),
+    created: jsonSchemaBuilder_1.jsonSchema.unixTimestamp2000().optional(),
+    updated: jsonSchemaBuilder_1.jsonSchema.unixTimestamp2000().optional(),
 });
 exports.savedDBEntityJsonSchema = jsonSchemaBuilder_1.jsonSchema.object({
     id: jsonSchemaBuilder_1.jsonSchema.string(),
-    created: jsonSchemaBuilder_1.jsonSchema.unixTimestamp(),
-    updated: jsonSchemaBuilder_1.jsonSchema.unixTimestamp(),
+    created: jsonSchemaBuilder_1.jsonSchema.unixTimestamp2000(),
+    updated: jsonSchemaBuilder_1.jsonSchema.unixTimestamp2000(),
 });

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/dist-esm/datetime/localTime.js

@@ -36,6 +36,12 @@ export class LocalTime {
         }
         return t;
     }
+    /**
+     * Create LocalTime from unixTimestamp in milliseconds (not in seconds).
+     */
+    static ofMillis(millis) {
+        return LocalTime.of(new Date(millis));
+    }
     /**
      * Returns null if invalid
      */

package/dist-esm/json-schema/jsonSchemaBuilder.js

@@ -47,6 +47,9 @@ export const jsonSchema = {
     unixTimestamp() {
         return new JsonSchemaNumberBuilder().unixTimestamp();
     },
+    unixTimestamp2000() {
+        return new JsonSchemaNumberBuilder().unixTimestamp2000();
+    },
     // string types
     string() {
         return new JsonSchemaStringBuilder();
@@ -163,7 +166,9 @@ export class JsonSchemaNumberBuilder extends JsonSchemaAnyBuilder {
         this.float = () => this.format('float');
         this.double = () => this.format('double');
         this.unixTimestamp = () => this.format('unixTimestamp');
+        this.unixTimestamp2000 = () => this.format('unixTimestamp2000');
         this.unixTimestampMillis = () => this.format('unixTimestampMillis');
+        this.unixTimestampMillis2000 = () => this.format('unixTimestampMillis2000');
         this.utcOffset = () => this.format('utcOffset');
         this.utcOffsetHours = () => this.format('utcOffsetHours');
     }
@@ -304,8 +309,8 @@ export class JsonSchemaObjectBuilder extends JsonSchemaAnyBuilder {
     baseDBEntity(idType = 'string') {
         Object.assign(this.schema.properties, {
             id: { type: idType },
-            created: { type: 'number', format: 'unixTimestamp' },
-            updated: { type: 'number', format: 'unixTimestamp' },
+            created: { type: 'number', format: 'unixTimestamp2000' },
+            updated: { type: 'number', format: 'unixTimestamp2000' },
         });
         return this;
     }

package/dist-esm/json-schema/jsonSchemas.js

@@ -1,11 +1,11 @@
 import { jsonSchema } from './jsonSchemaBuilder';
 export const baseDBEntityJsonSchema = jsonSchema.object({
     id: jsonSchema.string().optional(),
-    created: jsonSchema.unixTimestamp().optional(),
-    updated: jsonSchema.unixTimestamp().optional(),
+    created: jsonSchema.unixTimestamp2000().optional(),
+    updated: jsonSchema.unixTimestamp2000().optional(),
 });
 export const savedDBEntityJsonSchema = jsonSchema.object({
     id: jsonSchema.string(),
-    created: jsonSchema.unixTimestamp(),
-    updated: jsonSchema.unixTimestamp(),
+    created: jsonSchema.unixTimestamp2000(),
+    updated: jsonSchema.unixTimestamp2000(),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.99.4",
+  "version": "14.102.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'
@@ -56,6 +61,13 @@ export class LocalTime {
     return t
   }
 
+  /**
+   * Create LocalTime from unixTimestamp in milliseconds (not in seconds).
+   */
+  static ofMillis(millis: UnixTimestampMillisNumber): LocalTime {
+    return LocalTime.of(new Date(millis))
+  }
+
   /**
    * Returns null if invalid
    */
@@ -471,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/json-schema/jsonSchemaBuilder.ts

@@ -78,6 +78,9 @@ export const jsonSchema = {
   unixTimestamp() {
     return new JsonSchemaNumberBuilder().unixTimestamp()
   },
+  unixTimestamp2000() {
+    return new JsonSchemaNumberBuilder().unixTimestamp2000()
+  },
   // string types
   string() {
     return new JsonSchemaStringBuilder()
@@ -246,7 +249,9 @@ export class JsonSchemaNumberBuilder extends JsonSchemaAnyBuilder<number, JsonSc
   float = () => this.format('float')
   double = () => this.format('double')
   unixTimestamp = () => this.format('unixTimestamp')
+  unixTimestamp2000 = () => this.format('unixTimestamp2000')
   unixTimestampMillis = () => this.format('unixTimestampMillis')
+  unixTimestampMillis2000 = () => this.format('unixTimestampMillis2000')
   utcOffset = () => this.format('utcOffset')
   utcOffsetHours = () => this.format('utcOffsetHours')
 }
@@ -370,8 +375,8 @@ export class JsonSchemaObjectBuilder<T extends AnyObject> extends JsonSchemaAnyB
   ): JsonSchemaObjectBuilder<T & BaseDBEntity<ID>> {
     Object.assign(this.schema.properties, {
       id: { type: idType },
-      created: { type: 'number', format: 'unixTimestamp' },
-      updated: { type: 'number', format: 'unixTimestamp' },
+      created: { type: 'number', format: 'unixTimestamp2000' },
+      updated: { type: 'number', format: 'unixTimestamp2000' },
     })
 
     return this

package/src/json-schema/jsonSchemas.ts

@@ -3,12 +3,12 @@ import { jsonSchema } from './jsonSchemaBuilder'
 
 export const baseDBEntityJsonSchema = jsonSchema.object<BaseDBEntity>({
   id: jsonSchema.string().optional(),
-  created: jsonSchema.unixTimestamp().optional(),
-  updated: jsonSchema.unixTimestamp().optional(),
+  created: jsonSchema.unixTimestamp2000().optional(),
+  updated: jsonSchema.unixTimestamp2000().optional(),
 })
 
 export const savedDBEntityJsonSchema = jsonSchema.object<SavedDBEntity>({
   id: jsonSchema.string(),
-  created: jsonSchema.unixTimestamp(),
-  updated: jsonSchema.unixTimestamp(),
+  created: jsonSchema.unixTimestamp2000(),
+  updated: jsonSchema.unixTimestamp2000(),
 })

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
  */