@naturalcycles/js-lib 14.136.1 → 14.138.0

package/dist/enum.util.d.ts

@@ -61,3 +61,5 @@ export declare function _numberEnumKeyNullable<T extends NumberEnum>(en: T, v: T
  * Returns a String key for given NumberEnum value, throws if not found.
  */
 export declare function _numberEnumKey<T extends NumberEnum>(en: T, v: T[keyof T] | undefined | null): keyof T;
+export declare function _stringEnumKeyNullable<T extends StringEnum>(en: T, v: string | undefined | null): keyof T | undefined;
+export declare function _stringEnumKey<T extends StringEnum>(en: T, v: string | undefined | null): keyof T;

package/dist/enum.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._numberEnumKey = exports._numberEnumKeyNullable = exports._numberEnumNormalizeNullable = exports._numberEnumNormalize = exports._numberEnumInverseNullable = exports._numberEnumInverse = exports._stringEnumEntries = exports._numberEnumEntries = exports._stringEnumValues = exports._stringEnumKeys = exports._numberEnumValues = exports._numberEnumKeys = void 0;
+exports._stringEnumKey = exports._stringEnumKeyNullable = exports._numberEnumKey = exports._numberEnumKeyNullable = exports._numberEnumNormalizeNullable = exports._numberEnumNormalize = exports._numberEnumInverseNullable = exports._numberEnumInverse = exports._stringEnumEntries = exports._numberEnumEntries = exports._stringEnumValues = exports._stringEnumKeys = exports._numberEnumValues = exports._numberEnumKeys = void 0;
 /**
  * Returns all number keys of a number-enum.
  */
@@ -49,7 +49,7 @@ exports._numberEnumEntries = _numberEnumEntries;
  * Doesn't work on Number-enums!
  */
 function _stringEnumEntries(en) {
-    return Object.keys(en).map(k => [k, en[k]]);
+    return Object.entries(en);
 }
 exports._stringEnumEntries = _stringEnumEntries;
 /**
@@ -110,7 +110,20 @@ function _numberEnumKey(en, v) {
     const key = en[v];
     // This prevents passing a Key (not a Value) of enum here, which returns unexpected result (number, not string)
     if (typeof key !== 'string')
-        throw new Error(`_enumKey value not found for: ${v}`);
+        throw new Error(`_numberEnumKey not found for: ${v}`);
     return key;
 }
 exports._numberEnumKey = _numberEnumKey;
+function _stringEnumKeyNullable(en, 
+// v: T[keyof T] | undefined | null, // cannot make it type-safe :(
+v) {
+    return Object.entries(en).find(([_, v2]) => v2 === v)?.[0];
+}
+exports._stringEnumKeyNullable = _stringEnumKeyNullable;
+function _stringEnumKey(en, v) {
+    const r = _stringEnumKeyNullable(en, v);
+    if (!r)
+        throw new Error(`_stringEnumKey not found for: ${v}`);
+    return r;
+}
+exports._stringEnumKey = _stringEnumKey;

package/dist-esm/enum.util.js

@@ -41,7 +41,7 @@ export function _numberEnumEntries(en) {
  * Doesn't work on Number-enums!
  */
 export function _stringEnumEntries(en) {
-    return Object.keys(en).map(k => [k, en[k]]);
+    return Object.entries(en);
 }
 /**
  * Allows to return a Number enum value (typed as Enum itself) based on it's String key.
@@ -96,6 +96,18 @@ export function _numberEnumKey(en, v) {
     const key = en[v];
     // This prevents passing a Key (not a Value) of enum here, which returns unexpected result (number, not string)
     if (typeof key !== 'string')
-        throw new Error(`_enumKey value not found for: ${v}`);
+        throw new Error(`_numberEnumKey not found for: ${v}`);
     return key;
 }
+export function _stringEnumKeyNullable(en, 
+// v: T[keyof T] | undefined | null, // cannot make it type-safe :(
+v) {
+    var _a;
+    return (_a = Object.entries(en).find(([_, v2]) => v2 === v)) === null || _a === void 0 ? void 0 : _a[0];
+}
+export function _stringEnumKey(en, v) {
+    const r = _stringEnumKeyNullable(en, v);
+    if (!r)
+        throw new Error(`_stringEnumKey not found for: ${v}`);
+    return r;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.136.1",
+  "version": "14.138.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",
@@ -36,7 +36,7 @@
   "types": "dist/index.d.ts",
   "sideEffects": false,
   "engines": {
-    "node": ">=14.15.0"
+    "node": ">=18.12.0"
   },
   "publishConfig": {
     "access": "public"

package/readme.md

@@ -15,7 +15,7 @@
 # Packaging
 
 - `engines.node >= Node.js LTS`
-- `main: dist/index.js`: commonjs, es2021 - targeting Node.js
+- `main: dist/index.js`: commonjs, es2022 - targeting Node.js
 - `module: dist-esm/index.js`: esm, es2017 - targeting Browsers
 - `types: dist/index.d.ts`: typescript types
 - `/src` folder with source `*.ts` files included

package/src/enum.util.ts

@@ -48,7 +48,7 @@ export function _numberEnumEntries<T extends NumberEnum>(en: T): [k: string, v:
  * Doesn't work on Number-enums!
  */
 export function _stringEnumEntries<T extends StringEnum>(en: T): [k: string, v: T[keyof T]][] {
-  return Object.keys(en).map(k => [k, en[k]]) as any
+  return Object.entries(en) as any
 }
 
 /**
@@ -118,6 +118,20 @@ export function _numberEnumKey<T extends NumberEnum>(
 ): keyof T {
   const key = (en as any)[v]
   // This prevents passing a Key (not a Value) of enum here, which returns unexpected result (number, not string)
-  if (typeof key !== 'string') throw new Error(`_enumKey value not found for: ${v}`)
+  if (typeof key !== 'string') throw new Error(`_numberEnumKey not found for: ${v}`)
   return key
 }
+
+export function _stringEnumKeyNullable<T extends StringEnum>(
+  en: T,
+  // v: T[keyof T] | undefined | null, // cannot make it type-safe :(
+  v: string | undefined | null,
+): keyof T | undefined {
+  return Object.entries(en).find(([_, v2]) => v2 === v)?.[0]
+}
+
+export function _stringEnumKey<T extends StringEnum>(en: T, v: string | undefined | null): keyof T {
+  const r = _stringEnumKeyNullable(en, v)
+  if (!r) throw new Error(`_stringEnumKey not found for: ${v}`)
+  return r
+}