@naturalcycles/js-lib 14.137.0 → 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.137.0",
+  "version": "14.138.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",

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
+}