@naturalcycles/js-lib 14.154.0 → 14.155.1

package/dist/datetime/localTime.js

@@ -13,7 +13,7 @@ var ISODayOfWeek;
     ISODayOfWeek[ISODayOfWeek["FRIDAY"] = 5] = "FRIDAY";
     ISODayOfWeek[ISODayOfWeek["SATURDAY"] = 6] = "SATURDAY";
     ISODayOfWeek[ISODayOfWeek["SUNDAY"] = 7] = "SUNDAY";
-})(ISODayOfWeek = exports.ISODayOfWeek || (exports.ISODayOfWeek = {}));
+})(ISODayOfWeek || (exports.ISODayOfWeek = ISODayOfWeek = {}));
 const weekStartsOn = 1; // mon, as per ISO
 const MILLISECONDS_IN_WEEK = 604800000;
 const SECONDS_IN_DAY = 86400;

package/dist/env/buildInfo.d.ts

@@ -0,0 +1,36 @@
+import type { UnixTimestampNumber } from '../types';
+export interface BuildInfo {
+    /**
+     * Unix timestamp of when the build was made.
+     */
+    ts: UnixTimestampNumber;
+    /**
+     * Unix timestamp of commit ("committer date", not "author date")
+     */
+    tsCommit: UnixTimestampNumber;
+    repoName: string;
+    branchName: string;
+    /**
+     * GIT sha revision (first 7 characters)
+     */
+    rev: string;
+    /**
+     * "Version string" in the following format:
+     * yyyyMMdd_HHmm_$repoName_$branch_$rev
+     *
+     * E.g:
+     * 20190419_1728_myrepo_master_21aecf5
+     */
+    ver: string;
+    /**
+     * Build during development.
+     */
+    dev?: boolean;
+    /**
+     * Build "environment".
+     * Normally taken from process.env.APP_ENV
+     * Can be undefined.
+     */
+    env?: string;
+}
+export declare function generateBuildInfoDev(): BuildInfo;

package/dist/env/buildInfo.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateBuildInfoDev = void 0;
+const localTime_1 = require("../datetime/localTime");
+function generateBuildInfoDev() {
+    const now = (0, localTime_1.localTime)();
+    const ts = now.unix();
+    const rev = 'devRev';
+    const branchName = 'devBranch';
+    const repoName = 'devRepo';
+    const tsCommit = now.unix();
+    const ver = [now.toStringCompact(), repoName, branchName, rev].join('_');
+    return {
+        ts,
+        tsCommit,
+        repoName,
+        branchName,
+        rev,
+        ver,
+        env: 'dev',
+    };
+}
+exports.generateBuildInfoDev = generateBuildInfoDev;

package/dist/error/errorMode.js

@@ -20,4 +20,4 @@ var ErrorMode;
      * Completely suppress errors, do not aggregate nor throw anything. Resilient mode.
      */
     ErrorMode["SUPPRESS"] = "SUPPRESS";
-})(ErrorMode = exports.ErrorMode || (exports.ErrorMode = {}));
+})(ErrorMode || (exports.ErrorMode = ErrorMode = {}));

package/dist/index.d.ts

@@ -79,6 +79,7 @@ export * from './http/http.model';
 export * from './http/fetcher';
 export * from './http/fetcher.model';
 export * from './string/hash.util';
+export * from './env/buildInfo';
 export * from './zod/zod.util';
 export * from './zod/zod.shared.schemas';
 import { z, ZodSchema, ZodError, ZodIssue } from 'zod';

package/dist/index.js

@@ -83,6 +83,7 @@ tslib_1.__exportStar(require("./http/http.model"), exports);
 tslib_1.__exportStar(require("./http/fetcher"), exports);
 tslib_1.__exportStar(require("./http/fetcher.model"), exports);
 tslib_1.__exportStar(require("./string/hash.util"), exports);
+tslib_1.__exportStar(require("./env/buildInfo"), exports);
 tslib_1.__exportStar(require("./zod/zod.util"), exports);
 tslib_1.__exportStar(require("./zod/zod.shared.schemas"), exports);
 const zod_1 = require("zod");

package/dist/lazy.js

@@ -37,7 +37,9 @@ exports._lazyValue = _lazyValue;
  * Based on: https://github.com/sindresorhus/define-lazy-prop
  */
 function _defineLazyProperty(obj, propertyName, fn) {
-    const define = (value) => Object.defineProperty(obj, propertyName, { value, enumerable: true, writable: true });
+    const define = (value) => {
+        Object.defineProperty(obj, propertyName, { value, enumerable: true, writable: true });
+    };
     Object.defineProperty(obj, propertyName, {
         configurable: true,
         enumerable: true,

package/dist/vendor/is.js

@@ -334,7 +334,7 @@ var AssertionTypeDescription;
     AssertionTypeDescription["inRange"] = "in range";
     AssertionTypeDescription["any"] = "predicate returns truthy for any value";
     AssertionTypeDescription["all"] = "predicate returns truthy for all values";
-})(AssertionTypeDescription = exports.AssertionTypeDescription || (exports.AssertionTypeDescription = {}));
+})(AssertionTypeDescription || (exports.AssertionTypeDescription = AssertionTypeDescription = {}));
 exports.assert = {
     // Unknowns.
     undefined: (value) => assertType(is.undefined(value), 'undefined', value),

package/dist-esm/env/buildInfo.js

@@ -0,0 +1,19 @@
+import { localTime } from '../datetime/localTime';
+export function generateBuildInfoDev() {
+    const now = localTime();
+    const ts = now.unix();
+    const rev = 'devRev';
+    const branchName = 'devBranch';
+    const repoName = 'devRepo';
+    const tsCommit = now.unix();
+    const ver = [now.toStringCompact(), repoName, branchName, rev].join('_');
+    return {
+        ts,
+        tsCommit,
+        repoName,
+        branchName,
+        rev,
+        ver,
+        env: 'dev',
+    };
+}

package/dist-esm/index.js

@@ -79,6 +79,7 @@ export * from './http/http.model';
 export * from './http/fetcher';
 export * from './http/fetcher.model';
 export * from './string/hash.util';
+export * from './env/buildInfo';
 export * from './zod/zod.util';
 export * from './zod/zod.shared.schemas';
 import { z, ZodSchema, ZodError } from 'zod';

package/dist-esm/lazy.js

@@ -33,7 +33,9 @@ export function _lazyValue(fn) {
  * Based on: https://github.com/sindresorhus/define-lazy-prop
  */
 export function _defineLazyProperty(obj, propertyName, fn) {
-    const define = (value) => Object.defineProperty(obj, propertyName, { value, enumerable: true, writable: true });
+    const define = (value) => {
+        Object.defineProperty(obj, propertyName, { value, enumerable: true, writable: true });
+    };
     Object.defineProperty(obj, propertyName, {
         configurable: true,
         enumerable: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.154.0",
+  "version": "14.155.1",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",
@@ -20,11 +20,14 @@
     "@types/node": "^20.1.0",
     "crypto-js": "^4.1.1",
     "jest": "^29.0.0",
-    "prettier": "^2.1.2",
+    "prettier": "^3.0.0",
     "rxjs": "^7.0.1",
     "vuepress": "^1.7.1",
     "vuepress-plugin-typescript": "^0.3.1"
   },
+  "resolutions": {
+    "expect-type": "0.15.0"
+  },
   "files": [
     "dist",
     "dist-esm",

package/src/array/array.util.ts

@@ -97,13 +97,16 @@ export function _by<T>(items: readonly T[], mapper: Mapper<T, any>): StringMap<T
  * Returning `undefined` from the Mapper will EXCLUDE the item.
  */
 export function _groupBy<T>(items: readonly T[], mapper: Mapper<T, any>): StringMap<T[]> {
-  return items.reduce((map, item, index) => {
-    const res = mapper(item, index)
-    if (res !== undefined) {
-      map[res] = [...(map[res] || []), item]
-    }
-    return map
-  }, {} as StringMap<T[]>)
+  return items.reduce(
+    (map, item, index) => {
+      const res = mapper(item, index)
+      if (res !== undefined) {
+        map[res] = [...(map[res] || []), item]
+      }
+      return map
+    },
+    {} as StringMap<T[]>,
+  )
 }
 
 /**

package/src/datetime/dateInterval.ts

@@ -10,7 +10,10 @@ export type DateIntervalString = string
  * @experimental
  */
 export class DateInterval {
-  private constructor(public start: LocalDate, public end: LocalDate) {}
+  private constructor(
+    public start: LocalDate,
+    public end: LocalDate,
+  ) {}
 
   static of(start: LocalDateConfig, end: LocalDateConfig): DateInterval {
     return new DateInterval(LocalDate.of(start), LocalDate.of(end))

package/src/datetime/localDate.ts

@@ -21,7 +21,11 @@ export type LocalDateFormatter = (ld: LocalDate) => string
  * @experimental
  */
 export class LocalDate {
-  private constructor(private $year: number, private $month: number, private $day: number) {}
+  private constructor(
+    private $year: number,
+    private $month: number,
+    private $day: number,
+  ) {}
 
   static create(year: number, month: number, day: number): LocalDate {
     return new LocalDate(year, month, day)

package/src/datetime/timeInterval.ts

@@ -13,7 +13,10 @@ export type TimeIntervalString = string
  * @experimental
  */
 export class TimeInterval {
-  private constructor(private $start: UnixTimestampNumber, private $end: UnixTimestampNumber) {}
+  private constructor(
+    private $start: UnixTimestampNumber,
+    private $end: UnixTimestampNumber,
+  ) {}
 
   static of(start: LocalTimeConfig, end: LocalTimeConfig): TimeInterval {
     return new TimeInterval(

package/src/decorators/debounce.ts

@@ -51,7 +51,7 @@ export function _debounce<T extends AnyFunction>(
   const { leading = false, trailing = true } = opt
   const maxWait = maxing ? Math.max(Number(opt.maxWait) || 0, wait) : opt.maxWait
 
-  function invokeFunc(time: number) {
+  function invokeFunc(time: number): any {
     const args = lastArgs
     const thisArg = lastThis
 
@@ -65,11 +65,11 @@ export function _debounce<T extends AnyFunction>(
     return setTimeout(pendingFunc, wait) as any
   }
 
-  function cancelTimer(id: number) {
+  function cancelTimer(id: number): void {
     clearTimeout(id)
   }
 
-  function leadingEdge(time: number) {
+  function leadingEdge(time: number): any {
     // Reset any `maxWait` timer.
     lastInvokeTime = time
     // Start the timer for the trailing edge.
@@ -78,7 +78,7 @@ export function _debounce<T extends AnyFunction>(
     return leading ? invokeFunc(time) : result
   }
 
-  function remainingWait(time: number) {
+  function remainingWait(time: number): number {
     const timeSinceLastCall = time - lastCallTime!
     const timeSinceLastInvoke = time - lastInvokeTime
     const timeWaiting = wait - timeSinceLastCall
@@ -86,7 +86,7 @@ export function _debounce<T extends AnyFunction>(
     return maxing ? Math.min(timeWaiting, maxWait! - timeSinceLastInvoke) : timeWaiting
   }
 
-  function shouldInvoke(time: number) {
+  function shouldInvoke(time: number): boolean {
     const timeSinceLastCall = time - lastCallTime!
     const timeSinceLastInvoke = time - lastInvokeTime
 
@@ -101,7 +101,7 @@ export function _debounce<T extends AnyFunction>(
     )
   }
 
-  function timerExpired() {
+  function timerExpired(): any {
     const time = Date.now()
     if (shouldInvoke(time)) {
       return trailingEdge(time)
@@ -110,7 +110,7 @@ export function _debounce<T extends AnyFunction>(
     timerId = startTimer(timerExpired, remainingWait(time))
   }
 
-  function trailingEdge(time: number) {
+  function trailingEdge(time: number): any {
     timerId = undefined
 
     // Only invoke if we have `lastArgs` which means `func` has been
@@ -122,7 +122,7 @@ export function _debounce<T extends AnyFunction>(
     return result
   }
 
-  function cancel() {
+  function cancel(): void {
     if (timerId !== undefined) {
       cancelTimer(timerId)
     }
@@ -130,15 +130,15 @@ export function _debounce<T extends AnyFunction>(
     lastArgs = lastCallTime = lastThis = timerId = undefined
   }
 
-  function flush() {
+  function flush(): any {
     return timerId === undefined ? result : trailingEdge(Date.now())
   }
 
-  function pending() {
+  function pending(): boolean {
     return timerId !== undefined
   }
 
-  function debounced(this: any, ...args: any[]) {
+  function debounced(this: any, ...args: any[]): any {
     const time = Date.now()
     const isInvoking = shouldInvoke(time)
 

package/src/env/buildInfo.ts

@@ -0,0 +1,64 @@
+import { localTime } from '../datetime/localTime'
+import type { UnixTimestampNumber } from '../types'
+
+export interface BuildInfo {
+  /**
+   * Unix timestamp of when the build was made.
+   */
+  ts: UnixTimestampNumber
+
+  /**
+   * Unix timestamp of commit ("committer date", not "author date")
+   */
+  tsCommit: UnixTimestampNumber
+
+  repoName: string
+  branchName: string
+
+  /**
+   * GIT sha revision (first 7 characters)
+   */
+  rev: string
+
+  /**
+   * "Version string" in the following format:
+   * yyyyMMdd_HHmm_$repoName_$branch_$rev
+   *
+   * E.g:
+   * 20190419_1728_myrepo_master_21aecf5
+   */
+  ver: string
+
+  /**
+   * Build during development.
+   */
+  dev?: boolean
+
+  /**
+   * Build "environment".
+   * Normally taken from process.env.APP_ENV
+   * Can be undefined.
+   */
+  env?: string
+}
+
+export function generateBuildInfoDev(): BuildInfo {
+  const now = localTime()
+  const ts = now.unix()
+  const rev = 'devRev'
+  const branchName = 'devBranch'
+  const repoName = 'devRepo'
+  const tsCommit = now.unix()
+
+  const ver = [now.toStringCompact(), repoName, branchName, rev].join('_')
+
+  return {
+    ts,
+    tsCommit,
+    repoName,
+    branchName,
+    rev,
+    ver,
+    env: 'dev',
+  }
+}

package/src/index.ts

@@ -79,6 +79,7 @@ export * from './http/http.model'
 export * from './http/fetcher'
 export * from './http/fetcher.model'
 export * from './string/hash.util'
+export * from './env/buildInfo'
 export * from './zod/zod.util'
 export * from './zod/zod.shared.schemas'
 import { z, ZodSchema, ZodError, ZodIssue } from 'zod'

package/src/json-schema/jsonSchemaBuilder.ts

@@ -242,16 +242,16 @@ export class JsonSchemaNumberBuilder extends JsonSchemaAnyBuilder<number, JsonSc
     return this
   }
 
-  int32 = () => this.format('int32')
-  int64 = () => this.format('int64')
-  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')
+  int32 = (): this => this.format('int32')
+  int64 = (): this => this.format('int64')
+  float = (): this => this.format('float')
+  double = (): this => this.format('double')
+  unixTimestamp = (): this => this.format('unixTimestamp')
+  unixTimestamp2000 = (): this => this.format('unixTimestamp2000')
+  unixTimestampMillis = (): this => this.format('unixTimestampMillis')
+  unixTimestampMillis2000 = (): this => this.format('unixTimestampMillis2000')
+  utcOffset = (): this => this.format('utcOffset')
+  utcOffsetHours = (): this => this.format('utcOffsetHours')
 }
 
 export class JsonSchemaStringBuilder extends JsonSchemaAnyBuilder<string, JsonSchemaString> {
@@ -283,22 +283,22 @@ export class JsonSchemaStringBuilder extends JsonSchemaAnyBuilder<string, JsonSc
     return this
   }
 
-  email = () => this.format('email')
-  date = () => this.format('date')
-  url = () => this.format('url')
-  ipv4 = () => this.format('ipv4')
-  ipv6 = () => this.format('ipv6')
-  password = () => this.format('password')
-  id = () => this.format('id')
-  slug = () => this.format('slug')
-  semVer = () => this.format('semVer')
-  languageTag = () => this.format('languageTag')
-  countryCode = () => this.format('countryCode')
-  currency = () => this.format('currency')
+  email = (): this => this.format('email')
+  date = (): this => this.format('date')
+  url = (): this => this.format('url')
+  ipv4 = (): this => this.format('ipv4')
+  ipv6 = (): this => this.format('ipv6')
+  password = (): this => this.format('password')
+  id = (): this => this.format('id')
+  slug = (): this => this.format('slug')
+  semVer = (): this => this.format('semVer')
+  languageTag = (): this => this.format('languageTag')
+  countryCode = (): this => this.format('countryCode')
+  currency = (): this => this.format('currency')
 
-  trim = (trim = true) => this.transformModify('trim', trim)
-  toLowerCase = (toLowerCase = true) => this.transformModify('toLowerCase', toLowerCase)
-  toUpperCase = (toUpperCase = true) => this.transformModify('toUpperCase', toUpperCase)
+  trim = (trim = true): this => this.transformModify('trim', trim)
+  toLowerCase = (toLowerCase = true): this => this.transformModify('toLowerCase', toLowerCase)
+  toUpperCase = (toUpperCase = true): this => this.transformModify('toUpperCase', toUpperCase)
 
   private transformModify(t: 'trim' | 'toLowerCase' | 'toUpperCase', add: boolean): this {
     if (add) {

package/src/lazy.ts

@@ -42,8 +42,9 @@ export function _defineLazyProperty<OBJ extends AnyObject>(
   propertyName: keyof OBJ,
   fn: AnyFunction,
 ): OBJ {
-  const define = (value: any) =>
+  const define = (value: any): void => {
     Object.defineProperty(obj, propertyName, { value, enumerable: true, writable: true })
+  }
 
   Object.defineProperty(obj, propertyName, {
     configurable: true,

package/src/math/sma.ts

@@ -2,7 +2,10 @@
  * Implements a Simple Moving Average algorithm.
  */
 export class SimpleMovingAverage {
-  constructor(public readonly size: number, public readonly data: number[] = []) {}
+  constructor(
+    public readonly size: number,
+    public readonly data: number[] = [],
+  ) {}
 
   /**
    * Next index of array to push to

package/src/object/deepEquals.ts

@@ -15,7 +15,7 @@ export function _deepEquals(a: any, b: any): boolean {
     const arrB = isArray(b)
     let i
     let length
-    let key
+    let key: string
 
     if (arrA && arrB) {
       length = a.length
@@ -44,8 +44,8 @@ export function _deepEquals(a: any, b: any): boolean {
     for (i = length; i-- !== 0; ) if (!hasProp.call(b, keys[i]!)) return false
 
     for (i = length; i-- !== 0; ) {
-      key = keys[i]
-      if (!_deepEquals(a[key!], b[key!])) return false
+      key = keys[i]!
+      if (!_deepEquals(a[key], b[key])) return false
     }
 
     return true

package/src/object/object.util.ts

@@ -123,10 +123,13 @@ export function _mapValues<T extends AnyObject, OUT = T>(
   mapper: ObjectMapper<T, any>,
   mutate = false,
 ): OUT {
-  return Object.entries(obj).reduce((map, [k, v]) => {
-    map[k as keyof OUT] = mapper(k, v, obj)
-    return map
-  }, (mutate ? obj : {}) as OUT)
+  return Object.entries(obj).reduce(
+    (map, [k, v]) => {
+      map[k as keyof OUT] = mapper(k, v, obj)
+      return map
+    },
+    (mutate ? obj : {}) as OUT,
+  )
 }
 
 /**
@@ -165,13 +168,16 @@ export function _mapObject<IN extends AnyObject, OUT>(
   obj: IN,
   mapper: ObjectMapper<IN, [key: string, value: any]>,
 ): { [P in keyof IN]: OUT } {
-  return Object.entries(obj).reduce((map, [k, v]) => {
-    const r = mapper(k, v, obj) || []
-    if (r[0]) {
-      ;(map[r[0]] as any) = r[1]
-    }
-    return map
-  }, {} as { [P in keyof IN]: OUT })
+  return Object.entries(obj).reduce(
+    (map, [k, v]) => {
+      const r = mapper(k, v, obj) || []
+      if (r[0]) {
+        ;(map[r[0]] as any) = r[1]
+      }
+      return map
+    },
+    {} as { [P in keyof IN]: OUT },
+  )
 }
 
 export function _findKeyByValue<T extends AnyObject>(obj: T, v: ValueOf<T>): keyof T | undefined {

package/src/promise/pMap.ts

@@ -121,7 +121,7 @@ export async function pMap<IN, OUT>(
   }
 
   return await new Promise<OUT[]>((resolve, reject) => {
-    const next = () => {
+    const next = (): void => {
       if (isSettled) {
         return
       }

package/src/seq/seq.ts

@@ -15,7 +15,10 @@ import { END, SKIP } from '../types'
  * @experimental
  */
 export class Sequence<T> implements Iterable<T> {
-  private constructor(initialValue: T | typeof END, private nextFn: AbortableMapper<T, T>) {
+  private constructor(
+    initialValue: T | typeof END,
+    private nextFn: AbortableMapper<T, T>,
+  ) {
     this.currentValue = initialValue
   }
 
@@ -165,7 +168,10 @@ export function _seq<T>(initialValue: T | typeof END, nextFn: AbortableMapper<T,
  * @experimental
  */
 export class AsyncSequence<T> implements AsyncIterable<T> {
-  private constructor(initialValue: T | typeof END, private nextFn: AbortableAsyncMapper<T, T>) {
+  private constructor(
+    initialValue: T | typeof END,
+    private nextFn: AbortableAsyncMapper<T, T>,
+  ) {
     this.currentValue = initialValue
   }
 

package/src/string/readingTime.ts

@@ -41,7 +41,7 @@ export interface ReadingTimeResult extends ReadingTimeStats {
 
 type WordBoundFunction = (char: string) => boolean
 
-function codeIsInRanges(num: number, arrayOfRanges: number[][]) {
+function codeIsInRanges(num: number, arrayOfRanges: number[][]): boolean {
   return arrayOfRanges.some(([lowerBound, upperBound]) => lowerBound! <= num && num <= upperBound!)
 }
 

package/src/zod/zod.util.ts

@@ -44,7 +44,11 @@ export function zSafeValidate<T>(
 }
 
 export class ZodValidationError<T> extends ZodError<T> {
-  constructor(issues: ZodIssue[], public value: T, public schema: ZodSchema<T>) {
+  constructor(
+    issues: ZodIssue[],
+    public value: T,
+    public schema: ZodSchema<T>,
+  ) {
     super(issues)
   }