@naturalcycles/js-lib 15.9.1 → 15.11.0

package/dist/object/object.util.d.ts

@@ -1,5 +1,5 @@
 import type { MutateOptions } from '../array/array.util.js';
-import type { AnyObject, KeyValueTuple, ObjectMapper, ObjectPredicate, Reviver, ValueOf } from '../types.js';
+import type { AnyObject, KeyValueTuple, ObjectMapper, ObjectPredicate, Reviver, StringMap, ValueOf } from '../types.js';
 import { SKIP } from '../types.js';
 /**
  * Returns clone of `obj` with only `props` preserved.
@@ -93,6 +93,18 @@ export declare function _objectNullValuesToUndefined<T extends AnyObject>(obj: T
  * Deep copy object (by json parse/stringify, since it has unbeatable performance+simplicity combo).
  */
 export declare function _deepCopy<T>(o: T, reviver?: Reviver): T;
+/**
+ * Performance-optimized implementation of merging two objects
+ * without mutating any of them.
+ * (if you are allowed to mutate - there can be a faster implementation).
+ *
+ * Gives ~40% speedup with map sizes between 10 and 100k items,
+ * compared to {...obj1, ...obj2} or Object.assign({}, obj1, obj2).
+ *
+ * Only use it in hot paths that are known to be performance bottlenecks,
+ * otherwise it's not worth it (use normal object spread then).
+ */
+export declare function _mergeObjects<T>(obj1: StringMap<T>, obj2: StringMap<T>): StringMap<T>;
 /**
  * Returns `undefined` if it's empty (according to `_isEmpty()` specification),
  * otherwise returns the original object.

package/dist/object/object.util.js

@@ -192,6 +192,25 @@ export function _objectNullValuesToUndefined(obj, opt = {}) {
 export function _deepCopy(o, reviver) {
     return JSON.parse(JSON.stringify(o), reviver);
 }
+/**
+ * Performance-optimized implementation of merging two objects
+ * without mutating any of them.
+ * (if you are allowed to mutate - there can be a faster implementation).
+ *
+ * Gives ~40% speedup with map sizes between 10 and 100k items,
+ * compared to {...obj1, ...obj2} or Object.assign({}, obj1, obj2).
+ *
+ * Only use it in hot paths that are known to be performance bottlenecks,
+ * otherwise it's not worth it (use normal object spread then).
+ */
+export function _mergeObjects(obj1, obj2) {
+    const map = {};
+    for (const k of Object.keys(obj1))
+        map[k] = obj1[k];
+    for (const k of Object.keys(obj2))
+        map[k] = obj2[k];
+    return map;
+}
 /**
  * Returns `undefined` if it's empty (according to `_isEmpty()` specification),
  * otherwise returns the original object.

package/dist/zod/zod.shared.schemas.d.ts

@@ -1,11 +1,11 @@
 import { z } from 'zod/v4';
-import type { IsoDate } from '../types.js';
+import type { IsoDate, UnixTimestamp, UnixTimestampMillis } from '../types.js';
 export declare const TS_2500 = 16725225600;
 export declare const TS_2000 = 946684800;
-export declare const zUnixTimestamp: () => z.ZodNumber;
-export declare const zUnixTimestamp2000: () => z.ZodNumber;
-export declare const zUnixTimestampMillis: () => z.ZodNumber;
-export declare const zUnixTimestampMillis2000: () => z.ZodNumber;
+export declare const zUnixTimestamp: () => z.ZodCustom<UnixTimestamp>;
+export declare const zUnixTimestamp2000: () => z.ZodCustom<UnixTimestamp>;
+export declare const zUnixTimestampMillis: () => z.ZodCustom<UnixTimestampMillis>;
+export declare const zUnixTimestampMillis2000: () => z.ZodCustom<UnixTimestampMillis>;
 export declare const zSemVer: () => z.ZodString;
 export declare const zIsoDate: () => z.ZodCustom<IsoDate>;
 export declare const zEmail: () => z.ZodEmail;
@@ -32,8 +32,8 @@ export declare const customZodSchemas: {
     jwt: () => z.ZodString;
     slug: () => z.ZodString;
     semver: () => z.ZodString;
-    unixTimestamp: () => z.ZodNumber;
-    unixTimestamp2000: () => z.ZodNumber;
-    unixTimestampMillis: () => z.ZodNumber;
-    unixTimestampMillis2000: () => z.ZodNumber;
+    unixTimestamp: () => z.ZodCustom<UnixTimestamp>;
+    unixTimestamp2000: () => z.ZodCustom<UnixTimestamp>;
+    unixTimestampMillis: () => z.ZodCustom<UnixTimestampMillis>;
+    unixTimestampMillis2000: () => z.ZodCustom<UnixTimestampMillis>;
 };

package/dist/zod/zod.shared.schemas.js

@@ -6,28 +6,24 @@ export const zUnixTimestamp = () => z
     .int()
     .min(0)
     .max(TS_2500, 'Must be a UnixTimestamp number')
-    // .transform(v => v as UnixTimestamp) // breaks jsonSchema
     .describe('UnixTimestamp');
 export const zUnixTimestamp2000 = () => z
     .number()
     .int()
     .min(TS_2000)
     .max(TS_2500, 'Must be a UnixTimestamp number after 2000-01-01')
-    // .transform(v => v as UnixTimestamp)
     .describe('UnixTimestamp2000');
 export const zUnixTimestampMillis = () => z
     .number()
     .int()
     .min(0)
     .max(TS_2500 * 1000, 'Must be a UnixTimestampMillis number')
-    // .transform(v => v as UnixTimestampMillis)
     .describe('UnixTimestampMillis');
 export const zUnixTimestampMillis2000 = () => z
     .number()
     .int()
     .min(TS_2000 * 1000)
     .max(TS_2500 * 1000, 'Must be a UnixTimestampMillis number after 2000-01-01')
-    // .transform(v => v as UnixTimestampMillis)
     .describe('UnixTimestampMillis2000');
 export const zSemVer = () => z
     .string()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.9.1",
+  "version": "15.11.0",
   "dependencies": {
     "tslib": "^2",
     "zod": "^3"

package/src/object/object.util.ts

@@ -6,6 +6,7 @@ import type {
   ObjectMapper,
   ObjectPredicate,
   Reviver,
+  StringMap,
   ValueOf,
 } from '../types.js'
 import { _objectEntries, SKIP } from '../types.js'
@@ -246,6 +247,24 @@ export function _deepCopy<T>(o: T, reviver?: Reviver): T {
   return JSON.parse(JSON.stringify(o), reviver)
 }
 
+/**
+ * Performance-optimized implementation of merging two objects
+ * without mutating any of them.
+ * (if you are allowed to mutate - there can be a faster implementation).
+ *
+ * Gives ~40% speedup with map sizes between 10 and 100k items,
+ * compared to {...obj1, ...obj2} or Object.assign({}, obj1, obj2).
+ *
+ * Only use it in hot paths that are known to be performance bottlenecks,
+ * otherwise it's not worth it (use normal object spread then).
+ */
+export function _mergeObjects<T>(obj1: StringMap<T>, obj2: StringMap<T>): StringMap<T> {
+  const map: StringMap<T> = {}
+  for (const k of Object.keys(obj1)) map[k] = obj1[k]
+  for (const k of Object.keys(obj2)) map[k] = obj2[k]
+  return map
+}
+
 /**
  * Returns `undefined` if it's empty (according to `_isEmpty()` specification),
  * otherwise returns the original object.

package/src/zod/zod.shared.schemas.ts

@@ -1,44 +1,40 @@
 import { z } from 'zod/v4'
-import type { IsoDate } from '../types.js'
+import type { IsoDate, UnixTimestamp, UnixTimestampMillis } from '../types.js'
 
 export const TS_2500 = 16725225600 // 2500-01-01
 export const TS_2000 = 946684800 // 2000-01-01
 
-export const zUnixTimestamp = (): z.ZodNumber =>
+export const zUnixTimestamp = (): z.ZodCustom<UnixTimestamp> =>
   z
     .number()
     .int()
     .min(0)
     .max(TS_2500, 'Must be a UnixTimestamp number')
-    // .transform(v => v as UnixTimestamp) // breaks jsonSchema
-    .describe('UnixTimestamp')
+    .describe('UnixTimestamp') as unknown as z.ZodCustom<UnixTimestamp>
 
-export const zUnixTimestamp2000 = (): z.ZodNumber =>
+export const zUnixTimestamp2000 = (): z.ZodCustom<UnixTimestamp> =>
   z
     .number()
     .int()
     .min(TS_2000)
     .max(TS_2500, 'Must be a UnixTimestamp number after 2000-01-01')
-    // .transform(v => v as UnixTimestamp)
-    .describe('UnixTimestamp2000')
+    .describe('UnixTimestamp2000') as unknown as z.ZodCustom<UnixTimestamp>
 
-export const zUnixTimestampMillis = (): z.ZodNumber =>
+export const zUnixTimestampMillis = (): z.ZodCustom<UnixTimestampMillis> =>
   z
     .number()
     .int()
     .min(0)
     .max(TS_2500 * 1000, 'Must be a UnixTimestampMillis number')
-    // .transform(v => v as UnixTimestampMillis)
-    .describe('UnixTimestampMillis')
+    .describe('UnixTimestampMillis') as unknown as z.ZodCustom<UnixTimestampMillis>
 
-export const zUnixTimestampMillis2000 = (): z.ZodNumber =>
+export const zUnixTimestampMillis2000 = (): z.ZodCustom<UnixTimestampMillis> =>
   z
     .number()
     .int()
     .min(TS_2000 * 1000)
     .max(TS_2500 * 1000, 'Must be a UnixTimestampMillis number after 2000-01-01')
-    // .transform(v => v as UnixTimestampMillis)
-    .describe('UnixTimestampMillis2000')
+    .describe('UnixTimestampMillis2000') as unknown as z.ZodCustom<UnixTimestampMillis>
 
 export const zSemVer = (): z.ZodString =>
   z