@mediusinc/mng-commons 5.0.1-rc.0 → 5.1.0-rc.0

package/fesm2022/mediusinc-mng-commons-core.mjs

@@ -19,7 +19,7 @@ import { Title } from '@angular/platform-browser';
 import { filter, map, first, catchError } from 'rxjs/operators';
 import { DatePipe } from '@angular/common';
 import { HttpErrorResponse, HttpClient, HttpBackend } from '@angular/common/http';
-import { isObservable, of, mergeMap, combineLatest, Observable, tap, ReplaySubject, Subject, take, throwError } from 'rxjs';
+import { isObservable, of, mergeMap, combineLatest, Observable, tap, ReplaySubject, Subject, take, throwError as throwError$1 } from 'rxjs';
 import 'reflect-metadata';
 
 class DialogKeydownHandlerDirective {
@@ -1927,6 +1927,25 @@ function errorCauseToString(error, opts) {
     }
     return '';
 }
+/**
+ * Throws an error with the provided error message.
+ * The intended usage is for in-line throwing of an error with TS type narrowing.
+ * <br>
+ * <i>Example</i>:
+ * <pre>
+ *   const value: string | null = getValue("");
+ *   const nonNullValue: string = getValue("") ?? throwError("value missing");
+ * </pre>
+ *
+ * @param {string} errorMessage - The error message to be thrown.
+ * @param {CommonsErrorBaseOptions} [options] - Additional options for the thrown error.
+ * @throws {Error} - The error object with the provided error message.
+ * @returns {never} - This function does not return a value.
+ * @see CommonsErrorBaseOptions
+ */
+function throwError(errorMessage, options) {
+    throw new CommonsInternalError(errorMessage, options);
+}
 
 class CommonsErrorHandler {
     constructor() {
@@ -2108,74 +2127,6 @@ function getI18nErrorParams(error, params = {}) {
     return paramsRes;
 }
 
-const reflectTypeNameKey = 'typeName';
-const reflectEnumNameKey = 'enumName';
-/**
- * Defines type name decorator.
- * @param targetType class.
- * @param typeName Name of the type.
- */
-function defineReflectTypeName(targetType, typeName) {
-    if (!Reflect.hasOwnMetadata(reflectTypeNameKey, targetType)) {
-        Reflect.defineMetadata(reflectTypeNameKey, typeName, targetType);
-    }
-}
-/**
- * Defines enum name decorator.
- * @param targetType enum object.
- * @param enumName Name of the enum.
- */
-function defineReflectEnumName(targetType, enumName) {
-    if (!Reflect.hasOwnMetadata(reflectEnumNameKey, targetType)) {
-        Reflect.defineMetadata(reflectEnumNameKey, enumName, targetType);
-    }
-}
-/**
- * Gets type name from reflect metadata.
- * @param type Class.
- */
-function findReflectTypeName(type) {
-    if (!type) {
-        return null;
-    }
-    const typeName = Reflect.getMetadata(reflectTypeNameKey, type);
-    if (typeName) {
-        return typeName;
-    }
-    LoggerService.get().debug('WARNING: Reflect metadata could not be found for type, you might experience some issues in production build.', type?.name);
-    return type.name;
-}
-/**
- * Gets type name from either decorator or reflect metadata.
- * @param type Class.
- */
-function reflectTypeNameExists(type) {
-    return Reflect.hasOwnMetadata(reflectTypeNameKey, type);
-}
-/**
- * Gets enum name from either decorator or reflect metadata.
- * @param enumType Class.
- */
-function findReflectEnumName(enumType) {
-    const enumName = Reflect.getMetadata(reflectEnumNameKey, enumType);
-    if (enumName) {
-        return enumName;
-    }
-    LoggerService.get().debug(`WARNING: Reflect metadata could not be found for enum ${typeof enumType === 'object' ? Object.keys(enumType) : enumType}`, {
-        name: 'TypeUtilsError',
-        enumType: enumType
-    });
-    return null;
-}
-
-function getI18nClassNameAsync(translate, classType, singular) {
-    const typeName = findReflectTypeName(classType);
-    return getI18nTypeNameAsync(translate, typeName ?? '', singular);
-}
-function getI18nClassName(translate, classType, singular) {
-    const typeName = findReflectTypeName(classType);
-    return getI18nTypeName(translate, typeName ?? '', singular);
-}
 function getI18nTypeNameAsync(translate, typeName, singular) {
     const keys = getI18nTypeNameKeys(typeName, singular);
     return getI18nAsync(translate, undefined, ...keys);
@@ -2184,46 +2135,22 @@ function getI18nTypeName(translate, typeName, singular) {
     const keys = getI18nTypeNameKeys(typeName, singular);
     return getI18n(translate, undefined, ...keys);
 }
-function getI18nClassTabKey(classType, tab) {
-    const typeName = findReflectTypeName(classType);
-    return getI18nTypeTabKey(typeName ?? '', tab);
-}
 function getI18nTypeTabKey(typeName, tab) {
     return getI18nTypeKeyBasePath(typeName, 'tabs', tab);
 }
-function getI18nClassGroupKey(classType, group) {
-    const typeName = findReflectTypeName(classType);
-    return getI18nTypeGroupKey(typeName ?? '', group);
-}
 function getI18nTypeGroupKey(typeName, group) {
     return getI18nTypeKeyBasePath(typeName, 'groups', group);
 }
-function getI18nClassPropertyKey(classType, property) {
-    const typeName = findReflectTypeName(classType);
-    return getI18nTypePropertyKey(typeName ?? '', property);
-}
 function getI18nTypePropertyKey(typeName, property) {
     return getI18nTypeKeyBasePath(typeName, 'properties', property);
 }
-function getI18nClassKeyBasePath(classType, ...path) {
-    const typeName = findReflectTypeName(classType);
-    return getI18nTypeKeyBasePath(typeName ?? '', ...path);
-}
 function getI18nTypeKeyBasePath(typeName, ...path) {
     return `${typeName.length ? `${typeName}.` : ''}${path.join('.')}`;
 }
-function getI18nClassParams(translate, classType, item, params = {}) {
-    const typeName = findReflectTypeName(classType);
-    return getI18nTypeParams(translate, typeName ?? undefined, item, params);
-}
 function getI18nTypeParams(translate, typeName, item, params = {}) {
     const i18nTypeName = typeName ? getI18nTypeName(translate, typeName, true) : null;
     return populateI18nTypeParams(i18nTypeName ?? undefined, item, params);
 }
-function getI18nClassParamsAsync(translate, classType, item, params = {}) {
-    const typeName = findReflectTypeName(classType);
-    return getI18nTypeParamsAsync(translate, typeName ?? undefined, item, params);
-}
 function getI18nTypeParamsAsync(translate, typeName, item, params = {}) {
     return (typeName ? getI18nTypeNameAsync(translate, typeName, true) : of(null)).pipe(map(i18nTypeName => populateI18nTypeParams(i18nTypeName ?? undefined, item, params)));
 }
@@ -2328,6 +2255,66 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "17.3.4", ngImpor
                 }]
         }] });
 
+const reflectTypeNameKey = 'typeName';
+const reflectEnumNameKey = 'enumName';
+/**
+ * Defines type name decorator.
+ * @param targetType class.
+ * @param typeName Name of the type.
+ */
+function defineReflectTypeName(targetType, typeName) {
+    if (!Reflect.hasOwnMetadata(reflectTypeNameKey, targetType)) {
+        Reflect.defineMetadata(reflectTypeNameKey, typeName, targetType);
+    }
+}
+/**
+ * Defines enum name decorator.
+ * @param targetType enum object.
+ * @param enumName Name of the enum.
+ */
+function defineReflectEnumName(targetType, enumName) {
+    if (!Reflect.hasOwnMetadata(reflectEnumNameKey, targetType)) {
+        Reflect.defineMetadata(reflectEnumNameKey, enumName, targetType);
+    }
+}
+/**
+ * Gets type name from reflect metadata.
+ * @param type Class.
+ */
+function findReflectTypeName(type) {
+    if (!type) {
+        return null;
+    }
+    const typeName = Reflect.getMetadata(reflectTypeNameKey, type);
+    if (typeName) {
+        return typeName;
+    }
+    LoggerService.get().debug('WARNING: Reflect metadata could not be found for type, you might experience some issues in production build.', type?.name);
+    return type.name;
+}
+/**
+ * Gets type name from either decorator or reflect metadata.
+ * @param type Class.
+ */
+function reflectTypeNameExists(type) {
+    return Reflect.hasOwnMetadata(reflectTypeNameKey, type);
+}
+/**
+ * Gets enum name from either decorator or reflect metadata.
+ * @param enumType Class.
+ */
+function findReflectEnumName(enumType) {
+    const enumName = Reflect.getMetadata(reflectEnumNameKey, enumType);
+    if (enumName) {
+        return enumName;
+    }
+    LoggerService.get().debug(`WARNING: Reflect metadata could not be found for enum ${typeof enumType === 'object' ? Object.keys(enumType) : enumType}`, {
+        name: 'TypeUtilsError',
+        enumType: enumType
+    });
+    return null;
+}
+
 class EnumPipe {
     transform(value, enumDesc, i18nPath) {
         if (!value || (typeof value !== 'number' && typeof value !== 'string')) {
@@ -3512,6 +3499,20 @@ class CommonsConfigurationService {
     getConfigValue(key) {
         return this.configuration[key] ? this.configuration[key] : null;
     }
+    /**
+     * Gets the configuration value for the given key. If the value is not found,
+     * it throws an error with a custom error message.
+     *
+     * @param {string} key - The configuration key.
+     * @param {string} [errorMessage] - Custom error message to be thrown if the value is not found.
+     *
+     * @returns {T} - The configuration value.
+     *
+     * @throws {CommonsInternalError} - If the value is not found or a custom error message is provided.
+     */
+    getConfigValueOrThrow(key, errorMessage) {
+        return this.getConfigValue(key) ?? throwError(errorMessage ?? `Missing configuration value for '${key}'!`, { name: 'CommonsMissingConfigError' });
+    }
     /**
      * Has configuration for key.
      * @param key Configuration key.
@@ -3814,7 +3815,7 @@ class CommonsInitService {
             this.commonsInitServiceEvents.next(CommonsInitEventEnum.CommonsInitError);
             this.commonsInitServiceEvents.complete();
             this.isInitializedSubject.next(false);
-            return throwError(() => err);
+            return throwError$1(() => err);
         }));
     }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "17.3.4", ngImport: i0, type: CommonsInitService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
@@ -3948,5 +3949,5 @@ function provideCommons(config, ...features) {
  * Generated bundle index. Do not edit.
  */
 
-export { ACommonsErrorBase, APermissions, BROWSER_STORAGE_IT, BooleanPipe, COMMONS_INITIALIZER_IT, COMMONS_MODULE_CONFIG_IT, ClassMapPipe, CommonsConfigurationService, CommonsErrorHandler, CommonsFeatureTypeEnum, CommonsHttpError, CommonsInitEventEnum, CommonsInitService, CommonsInternalError, CommonsRouterService, CommonsService, ComponentDirective, DataProvider, DataProviderInst, DialogKeydownHandlerDirective, EnumName, EnumPipe, EnumerateAsyncPipe, EnumeratePipe, ErrorPageComponent, FilterMatchMode, GetterPipe, I18nPropertyPipe, JsonPathPipe, LOG_PUBLISHERS, LocalStorageService, LogLevelEnum, LogPublisherConsoleService, LoggerService, NotFoundPageComponent, NotificationWrapperComponent, ParametrizePipe, PermissionService, PermissionTypeEnum, Permissions, RouteBuilder, RoutesBuilder, StyleLevelEnum, StyleSizeEnum, Styles, TemplateDirective, TemplatePipe, TypeName, TypeRegistry, adjustRouteMenuLazyChildrenRouterLinks, angularDateFormatHasSeconds, angularDateFormatHasTime, appendRoutePathToBasePath, boolean$Attribute, commonsActionErrorContextToString, commonsErrorToString, commonsInitializerProvider, copyDataListParams, createLazyChildrenRoute, createLazyRoute, createRoute, createRouteRedirect, createRoutes, dataListParamsFilterToUrlQuery, dataListParamsFilterValueToUrlString, dataListParamsFiltersToUrlQuery, dataListParamsSortToUrlQuery, dataListParamsToUrlQuery, dataProviderBase, dataProviderFromClass, dataProviderWithService, dateToIsoString, defineReflectEnumName, defineReflectTypeName, doesUrlMatchRouterLink, errorCauseToString, errorToString, escapeHtml, escapeHtmlAny, findReflectEnumName, findReflectTypeName, findTemplateByName, flattenObjectKeys, fromAngularDateFormatToPrime, fromEnumConstantsAsValueArray, fromEnumValuesAsValueArray, fromSubscribeError, fromTableLoadToDataListParams, fromUrlQueryToDataListParams, getEnumConstantName, getEnumConstantNameFromObject, getEnumConstantNames, getEnumConstantNamesFromObject, getEnumConstantValuesAsNumber, getEnumConstantValuesAsString, getEnumerationI18nBaseKey, getErrorLogLevel, getErrorName, getHttpErrorResponse, getHttpErrorResponseStatus, getI18n, getI18nAsync, getI18nClassGroupKey, getI18nClassKeyBasePath, getI18nClassName, getI18nClassNameAsync, getI18nClassParams, getI18nClassParamsAsync, getI18nClassPropertyKey, getI18nClassTabKey, getI18nErrorParams, getI18nForError, getI18nTypeGroupKey, getI18nTypeKeyBasePath, getI18nTypeName, getI18nTypeNameAsync, getI18nTypeParams, getI18nTypeParamsAsync, getI18nTypePropertyKey, getI18nTypeTabKey, getObjectGetters, getObjectProperties, getObjectPropertyByPath, httpErrorResponseToString, isHttpErrorResponse, isPermitted, isRbacPermitted, itemIdToDefined, itemIdToNumber, itemIdToString, mapToDataList, mergeDataListParamsWithDefaults, number$Attribute, objectDeepCopy, objectDeepMerge, permissionGuard, populateI18nParams, populateI18nTypeParams, provideCommons, reflectEnumNameKey, reflectTypeNameExists, reflectTypeNameKey, removeRouteEmptyPathSegments, selectEnumerationI18n, selectI18n, stringify, toEnumerationI18nEnumerate, toObservable, toastMessage, valueToDefined };
+export { ACommonsErrorBase, APermissions, BROWSER_STORAGE_IT, BooleanPipe, COMMONS_INITIALIZER_IT, COMMONS_MODULE_CONFIG_IT, ClassMapPipe, CommonsConfigurationService, CommonsErrorHandler, CommonsFeatureTypeEnum, CommonsHttpError, CommonsInitEventEnum, CommonsInitService, CommonsInternalError, CommonsRouterService, CommonsService, ComponentDirective, DataProvider, DataProviderInst, DialogKeydownHandlerDirective, EnumName, EnumPipe, EnumerateAsyncPipe, EnumeratePipe, ErrorPageComponent, FilterMatchMode, GetterPipe, I18nPropertyPipe, JsonPathPipe, LOG_PUBLISHERS, LocalStorageService, LogLevelEnum, LogPublisherConsoleService, LoggerService, NotFoundPageComponent, NotificationWrapperComponent, ParametrizePipe, PermissionService, PermissionTypeEnum, Permissions, RouteBuilder, RoutesBuilder, StyleLevelEnum, StyleSizeEnum, Styles, TemplateDirective, TemplatePipe, TypeName, TypeRegistry, adjustRouteMenuLazyChildrenRouterLinks, angularDateFormatHasSeconds, angularDateFormatHasTime, appendRoutePathToBasePath, boolean$Attribute, commonsActionErrorContextToString, commonsErrorToString, commonsInitializerProvider, copyDataListParams, createLazyChildrenRoute, createLazyRoute, createRoute, createRouteRedirect, createRoutes, dataListParamsFilterToUrlQuery, dataListParamsFilterValueToUrlString, dataListParamsFiltersToUrlQuery, dataListParamsSortToUrlQuery, dataListParamsToUrlQuery, dataProviderBase, dataProviderFromClass, dataProviderWithService, dateToIsoString, defineReflectEnumName, defineReflectTypeName, doesUrlMatchRouterLink, errorCauseToString, errorToString, escapeHtml, escapeHtmlAny, findReflectEnumName, findReflectTypeName, findTemplateByName, flattenObjectKeys, fromAngularDateFormatToPrime, fromEnumConstantsAsValueArray, fromEnumValuesAsValueArray, fromSubscribeError, fromTableLoadToDataListParams, fromUrlQueryToDataListParams, getEnumConstantName, getEnumConstantNameFromObject, getEnumConstantNames, getEnumConstantNamesFromObject, getEnumConstantValuesAsNumber, getEnumConstantValuesAsString, getEnumerationI18nBaseKey, getErrorLogLevel, getErrorName, getHttpErrorResponse, getHttpErrorResponseStatus, getI18n, getI18nAsync, getI18nErrorParams, getI18nForError, getI18nTypeGroupKey, getI18nTypeKeyBasePath, getI18nTypeName, getI18nTypeNameAsync, getI18nTypeParams, getI18nTypeParamsAsync, getI18nTypePropertyKey, getI18nTypeTabKey, getObjectGetters, getObjectProperties, getObjectPropertyByPath, httpErrorResponseToString, isHttpErrorResponse, isPermitted, isRbacPermitted, itemIdToDefined, itemIdToNumber, itemIdToString, mapToDataList, mergeDataListParamsWithDefaults, number$Attribute, objectDeepCopy, objectDeepMerge, permissionGuard, populateI18nParams, populateI18nTypeParams, provideCommons, reflectEnumNameKey, reflectTypeNameExists, reflectTypeNameKey, removeRouteEmptyPathSegments, selectEnumerationI18n, selectI18n, stringify, throwError, toEnumerationI18nEnumerate, toObservable, toastMessage, valueToDefined };
 //# sourceMappingURL=mediusinc-mng-commons-core.mjs.map