v16.0.1

Bug Fixes

• fixes previous package release

v16.0.0

Features

• all interceptors now use updated IGNORED_INTERCEPTORS token, which works also with functions

BREAKING CHANGES

• minimal supported version of Node.js is 20.19.0
• minimal supported version of @angular packages is 20.3.2
• minimal supported version of @angular/material packages is 20.2.0
• minimal supported version of @anglr/common packages is 23.0.0

v15.0.1

Bug Fixes

• fixed HttpServerErrorInterceptor logging, now correctly displays error

v15.0.0

Features

• new httpGatewayTimeoutInterceptor http interceptor function, which is used for intercepting http responses and handling 504 statuses
• new httpServerErrorInterceptor http interceptor function, which is used for handling http server errors with codes 500..599 and displaying of internal server error
• new noConnectionInterceptor http interceptor function, which is used for intercepting http responses and handling 0 statuses
• new serviceUnavailableInterceptor http interceptor function, which is used for intercepting http responses and handling 503 statuses
• new CatchHttpClientErrorHttpStatusCodeOptions interface, which represents options for cattch http client errors specific for http status code
  • properties
    • behavior behavior of catch http client error, default is CatchHttpClientErrorBehavior.Suppress
    • skipErrorNotifications indication whether skip displaying of notifications for errors
    • skipServerValidationErrors indication whether skip server validation errors processing
    • forceCustomMessageDisplay indication whether forcibly display custom message if present, not only as fallback but always
    • message object storing default messages to be displayed for specific http status codes
• new HttpClientErrorConfigs type, that is object storing specific options/config according status code
• new HTTP_CLIENT_ERROR_CONFIGS injection token, that contains custom configs for http client error handlers for specific http status codes
• new provideHttpClientErrorConfigs provider, which provides http client error handlers and merges them with existing provided handlers
• updated CatchHttpClientErrorOptions interface
  • new configs property, with specific options/config for http status codes
• updated handleHttpClientErrors error handler
  • now use new configs property as priority for handling of errors
• updated handleHttp404Error error handler
  • now use new configs property as priority for handling of errors
• subpackage @anglr/error-handling/rest
  • updated RestCatchHttpClientError interface
    • new configs property, object storing options/config for specific http status codes
  • updated HttpClientErrorBehavior decorator
    • new parameter
      • statusCode if specified, behavior will be set for specific http status code
  • updated HttpClientErrorForceCustomMessage decorator
    • new parameter
      • statusCode if specified, force custom message display will be set for specific http status code
  • updated HttpClientErrorSkipErrorNotifications decorator
    • new parameter
      • statusCode if specified, skip error notifications will be set for specific http status code
  • updated HttpClientErrorSkipServerValidationErrors decorator
    • new parameter
      • statusCode if specified, skip server validation errors will be set for specific http status code

BREAKING CHANGES

• removed handle4xxFunc error handler, use new ones
• removed handle400WithValidationsFunc error handler, use new ones
• removed handle404Func error handler, use new ones
• removed handle4xxSuppress rxjs operator, use new ones
• removed handle4xx rxjs operator, use new ones
• removed handle400WithValidations rxjs operator, use new ones
• removed handle404 rxjs operator, use new ones
• removed handle404Suppress rxjs operator, use new ones
• removed Handle4xxOptions interface, use new ones
• removed XXXHttpClientError interface, use new ones
• removed ClientValidationError class, use new ones
• removed RestClientError class, use new ones
• removed RestNotFoundError class, use new ones
• removed HttpClientErrorCustomHandler type
• removed HTTP_CLIENT_ERROR_MESSAGES injection token, functionality moved into HTTP_CLIENT_ERROR_CONFIGS
• removed provideHttpClientErrorMessages provider, functionality moved into provideHttpClientErrorConfigs
• updated CatchHttpClientErrorOptions interface
  • removed messages property, functionality moved into configs property
• subpackage @anglr/error-handling/rest
  • removed ClientErrorHandlingBehavior enum
  • removed ClientErrorHandlingOptions class
  • removed getDefaultClientErrorObservable function
  • removed RestHttpClientErrors interface
  • removed CLIENT_ERROR_HANDLING_MIDDLEWARE_OPTIONS injection token
  • removed HTTP_CLIENT_ERROR_CUSTOM_HANDLER injection token
  • removed HTTP_IGNORED_CLIENT_ERRORS injection token, use one from base package
  • removed HttpClientErrorCustomHandlerDef type
  • removed getErrorHandlers function
  • removed ClientErrorHandlingMiddleware middleware
  • removed ErrorPassThrough decorator
  • removed ErrorPassThroughHttp decorator
  • removed Handle400WithValidations decorator
  • removed Handle404 decorator
  • removed IgnoreClientErrors decorator
  • removed SuppressError decorator
  • removed WithRestClientError decorator
  • updated RestCatchHttpClientError interface
    • removed messages property, functionality moved into configs property

v14.0.0

BREAKING CHANGES

• minimal supported version of NodeJs is 18
• minimal supported version of @angular packages is 19.1.0
• minimal supported version of @anglr/common is 22.0.0
• minimal supported version of @jscrpt/common is 7.0.0
• minimal supported version of tslib is 2.8.1
• renamed DialogInternalServerErrorSAComponent component to DialogInternalServerErrorComponent
• renamed InternalServerErrorSAComponent component to InternalServerErrorComponent

v13.0.0

Bug Fixes

• fixed package.json default export for material subpackage

Features

• new HttpClientErrorHandlers type, that is object storing error handlers for http client errors according status code
• new HttpClientErrorMessages type, that is object storing error messages for http client errors according status code
• new provideAnglrExceptionExtenders function, that provides anglr exception extends functions
• new provideInternalServerErrorRenderer function, that provides internal server error renderer type
• new DummyInternalServerErrorRenderer service, that is dummy renderer used for displaying/rendering internal server error
• new handleHttpClientErrorResponse function, that handles http error response with code 400..499 and returns HttpClientError, otherwise returns original http error response
• new handleHttpClientErrors function, that handles http client errors according provided options
• new handleHttp404Error function, that is custom handler for http 404 status codes
• new applyBehavior function, that gets result of catch http client error according provided behavior
• new provideHttpClientErrorMessages function, that provides http client error messages and merges them with existing provided messages
• new provideHttpClientErrorHandlers function, that provides http client error handlers and merges them with existing provided handlers
• new provideHttpClientErrorResponseMapper function, that provides http client error response mapper function
• new provideHttpClientValidationErrorResponseMapper function, that provides http client validation error response mapper function
• new processHttpClientErrorResponse rxjs operator, that processes http client error response with code 400..499 and converts it into HttpClientError, otherwise throw original http error response
• new catchHttpClientError rxjs operator, that catches http client errors and handles them according provided options
• new CatchHttpClientErrorBehavior enum, that is enumeration of available behavior for catch http client error
  • Suppress error is processed, but observable never completes
  • PassThrogh httpClientError object is returned as result of observable
  • Throw httpClientError object is 'thrown' as error from observable
• new CatchHttpClientErrorOptions interface, that represents options for catch http client errors
  • properties
    • injector instance of injector used for obtaining dependencies
    • behavior behavior of catch http client error, default is CatchHttpClientErrorBehavior.Suppress
    • skipErrorNotifications indication whether skip displaying of notifications for errors
    • skipServerValidationErrors indication whether skip server validation errors processing
    • forceCustomMessageDisplay indication whether forcibly display custom message if present, not only as fallback but always
    • messages object storing default messages to be displayed for specific http status codes
    • handlers object storing default error handlers for specific http status codes
• new HttpClientErrorHandler interface, that represents function that is used for handling http client error according status code
• new HttpClientErrorOptions interface, that represents options used for common handling of client errors
  • properties
    • injector injector used for obtaining dependencies
    • clientErrorsResponseMapper response mapper for http client errors
    • clientValidationErrorsResponseMapper response mapper for http client validation errors
    • ignoredHttpStatusCodes array of ignored http status codes that will not be processed
• new HttpClientError class, that represents information about http client error (400..499)
  • properties
    • errors array of processed client errors
    • validationErrors object storing server valiation errors
    • statusCode http status code
    • message http error response message
    • response complete http error response object
• new HttpNotFoundError class, that represents information about http not found error (404)
• new HTTP_IGNORED_CLIENT_ERRORS injection token, that contains array of http status codes that are ignored
• new HTTP_CLIENT_ERROR_MESSAGES injection token that contains custom client error messages
• new HTTP_CLIENT_ERROR_HANDLERS injection token that contains custom client error handlers
• updated InternalServerErrorSAComponent component
  • is now standalone
• updated HttpClientErrorResponseMapper type, return type is now PromiseOr, supports async usage
• updated HttpClientValidationErrorResponseMapper type, return type is now PromiseOr, supports async usage
• subpackage @anglr/error-handling/rest
  • new HttpClientErrorProcessingMiddleware middleware, that is used for processing http client errors (400..499)
  • new CatchHttpClientErrorMiddleware middleware, that catches http client error and handles according options
  • new HttpClientErrorsMapper decorator, that sets custom http client errors mapper function
  • new HttpClientValidationErrorsMapper decorator, that sets custom http client validation errors mapper function
  • new IgnoredHttpErrorStatusCodes decorator, that sets ignored http error status codes that will be ignored by http client error processing middleware
  • new HttpClientErrorMessages decorator, that sets http client error messages
  • new HttpClientErrorHandlers decorator, that sets http client error handlers
  • new HttpClientErrorBehavior decorator, that sets http client error behavior
  • new HttpClientErrorForceCustomMessage decorator, that sets http client error to force custom message displaying
  • new HttpClientErrorSkipErrorNotifications decorator, that sets http client error to skip error notifications
  • new HttpClientErrorSkipServerValidationErrors decorator, that sets http client error to skip server validation errors
  • new RestHttpClientErrorProcessing interface, configuration that can be used within http client error processing middleware
    • properties
      • clientErrorsResponseMapper response mapper for http client errors
      • clientValidationErrorsResponseMapper response mapper for http client validation errors
      • ignoredHttpStatusCodes array of ignored http status codes that will not be processed
  • new RestCatchHttpClientError interface, configuration that can be used within catch http client error middleware
    • properties
      • behavior behavior of catch http client error, default is CatchHttpClientErrorBehavior.Suppress
      • skipErrorNotifications indication whether skip displaying of notifications for errors
      • skipServerValidationErrors indication whether skip server validation errors processing
      • forceCustomMessageDisplay indication whether forcibly display custom message if present, not only as fallback but always
      • messages object storing default messages to be displayed for specific http status codes
      • handlers object storing default error handlers for specific http status codes
• subpackage @anglr/error-handling/material
  • updated DialogInternalServerErrorSAComponent component
    • is now standalone

BREAKING CHANGES

• minimal supported version of NodeJs is 18
• minimal supported version of @angular is 17.0.1
• minimal supported version of @angular material is 17.0.0
• minimal supported version of @jscrpt/common is 5.0.0
• minimal supported version of @anglr/common is 19.0.0
• minimal supported version of @anglr/rest is 14.0.0
• minimal supported version of tslib is 2.6.2
• removed ERROR_WITH_URL_EXTENDER provider, use provideAnglrExceptionExtenders to provide it
• removed InternalServerErrorModule, InternalServerErrorSAComponent is now standalone
• removed ServerValidationsModule, ServerValidationValidatorSADirective is now standalone
• renamed InternalServerErrorComponent to InternalServerErrorSAComponent
• updated readErrorsFromHttpErrorResponse function, is now async
• subpackage @anglr/error-handling/html2canvas
  • removed ERROR_WITH_SCREENSHOT_EXTENDER provider, use provideAnglrExceptionExtenders to provide it
• subpackage @anglr/error-handling/material
  • removed DIALOG_INTERNAL_SERVER_ERROR_RENDERER_PROVIDER provider, use provideInternalServerErrorRenderer to provide it
  • removed DialogInternalServerErrorModule, DialogInternalServerErrorSAComponent is now standalone
  • renamed DialogInternalServerErrorComponent to DialogInternalServerErrorSAComponent

v12.0.1

Bug Fixes

• fixed HttpServerErrorInterceptor imports, which points to itself

v12.0.0

Bug Fixes

• fixed Handle400WithValidations decorator, now correctly registers custom handler for 400 http status code

Features

• now also typings are available for external usage
• new readErrorsFromHttpErrorResponse function, that reads errors and validation errors from http error response
• new HttpClientErrors interface, which represents definition of http client errors read from http error response
  • properties
    • errors array of error
    • validationErrors object storing validation errors
• new HttpClientError interface, which represents http client error, containing extracted errors and original
  • extends
    • HttpClientErrors
  • properties
    • httpResponse original http error response
• new handle4xxSuppress rxjs operator, that handles http error response with code 400..499 as response and never returns
• new handle404Suppress rxjs operator, that handles 404 http code as response and never returns
• updated handle404 rxjs operator function
  • new parameter options containing injector and mapper function for extraction of error messages
• subpackage @anglr/error-handling/rest
  • new ClientErrorHandlingBehavior enum, which represents behavior for client error handling
    • values
      • Suppress result of http request with client error is handled by handler but observable never finishes
      • PassThrough result of http request with client error is handled by handler and extracted errors passes through to observable
      • PassThroughHttp result of http request with client error is handled by handler and extracted errors passes through to observable with original http error
      • RestClientError result of http request with client error is handled by handler and observable returns instance of RestClientError or its descendants
  • new ClientErrorHandlingOptions class, which represents options for client error handling
    • properties
      • behavior behavior of client error handling
      • defaultHandler default error handler to be used if no other configured handler was found
      • defaultClientError default factory for obtaining RestClientError
      • defaultClientValidationError default factory for obtaining ClientValidationError
  • new CLIENT_ERROR_HANDLING_MIDDLEWARE_OPTIONS injection token for global client error handling middleware options
  • new getDefaultClientErrorObservable function which, gets observable for error according specified behavior
  • new HttpClientErrorCustomHandlerDef type, that represents definition of http client error custom handler types
  • new ErrorPassThrough decorator, which changes behavior of ClientErrorHandlingMiddleware to pass through errors
  • new ErrorPassThroughHttp decorator, which changes behavior of ClientErrorHandlingMiddleware to pass through errors and http error response
  • new SuppressError decorator, which changes behavior of ClientErrorHandlingMiddleware to suppress errors
  • new WithRestClientError decorator, which changes behavior of ClientErrorHandlingMiddleware to rest client error
  • new getErrorHandlers function, which gets error handler functions to be used for handling errors
  • updated RestHttpClientErrors interface
    • new extends
      • Partial<ClientErrorHandlingMiddlewareOptions>
  • updated HTTP_CLIENT_ERROR_CUSTOM_HANDLER injection token
    • now of type HttpClientErrorCustomHandlerDef

BREAKING CHANGES

• minimal supported version of rxjs is 7.5.7
• minimal supported version of @jscrpt/common is 3.3.0
• minimal supported version of @anglr/common is 15.0.1
• minimal supported version of tslib is 2.4.0
• updated Handle4xxOptions interface
  • injector is now optional
• removed HttpClientErrorInterceptor http interceptor
• removed HTTP_CLIENT_ERROR_INTERCEPTOR_PROVIDER injection token
• removed WithRestClientContext class
• removed resolveWithRestClientContext function
• removed Handle400WithValidationsOptions interface, properties are now part of Handle4xxOptions
• renamed ɵhandle4xxFunction function to handle4xxFunc
• removed handle4xxFunc original function
• renamed ɵHandle400WithValidationsFunction function to handle400WithValidationsFunc
• removed handle400WithValidationsFunc original function
• moved HTTP_IGNORED_CLIENT_ERRORS into subpackage @anglr/error-handling/rest
• moved HTTP_CLIENT_ERROR_CUSTOM_HANDLER into subpackage @anglr/error-handling/rest
• updated handle404Func function
  • changed signature
• updated HttpClientErrorCustomHandler type
  • changed signature

v11.0.0

Features

• new ERROR_HANDLING_REST_MIDDLEWARES_ORDER constant, that represents definition of array of rest middlewares order including error handling middleware
• new middlewareTypes type, that represents array of middleware names that are available in error-handling library
• new REST_ERROR_HANDLING_MIDDLEWARE_ORDER provider, that is provider for rest middleware order with error handling middleware
• updated ClientErrorHandlingMiddleware middleware, now middleware type has static id to correspond with RestMiddlewareType<RestMiddleware>

BREAKING CHANGES

• minimal supported version of @angular is 14.0.0
• minimal supported version of @anglr/rest is 12.0.0
• minimal supported version of @anglr/common is 11.2.0
• dropped support of NodeJs version 12

v10.0.0

Features

• ERROR HANDLERS
  • new handle400WithValidationsFunc function, that handles http error response with code 400 and process validations errors and returns RestClientError or RestClientValidationError
  • new handle404Func function, that handles http error response with code 404 and returns RestNotFoundError
  • new handle4xxFunc function, that handles http error response with code 400..499 and returns RestClientError
• INTERCEPTORS
  • new HttpClientErrorInterceptor http interceptor, that is used for handling http server errors with codes 400..499
  • new HttpServerErrorInterceptor http interceptor, that is used for handling http server errors with codes 500..599 and displaying of internal server error
  • new HTTP_SERVER_ERROR_INTERCEPTOR_PROVIDER provider for proper use of HttpServerErrorInterceptor, use this provider to inject this interceptor
  • new HTTP_CLIENT_ERROR_INTERCEPTOR_PROVIDER provider for proper use of HttpClientErrorInterceptor, use this provider to inject this interceptor
• new HttpClientErrorResponseMapper type, that represents response mapper for http client errors that are converted to array of error messages
• new HttpClientValidationErrorResponseMapper type, that represents response mapper for http client validation errors that are converted into object RestClientValidationErrors
• new HttpClientErrorCustomHandler type, that represents custom handler for HttpErrorResponse
• new HttpClientPropertyValidationError interface, that represents validation errors for single validated property
• new HttpClientValidationErrors interface, that represents object storing validations errors from server
• new Handle4xxOptions interface, that options passed for handle 4xx http status codes
  • property injector injector used for obtaining dependencies
  • property clientErrorsResponseMapper response mapper for http client errors
• new Handle400WithValidationsOptions interface, that represents options passed for handle 400 http status code with validations
  • extends Handle4xxOptions
  • property clientValidationErrorsResponseMapper response mapper for http client validation errors
• new RestClientError class, that represents handled client error 4xx http status code
• new RestNotFoundError class, that represents handled 404 http status code
• new ClientValidationError class, that represents handled 400 http status code with validations
• SERVER VALIDATIONS
  • ServerValidationService service
    • new serverValidationProperties property, that gets array of server validation properties
    • new removeServerValidationError method, that removes validation errors for single property
  • ServerValidationValidatorDirective directive
    • now also tries to get property name from FormControlNameDirective
    • now uses new HttpClientValidationErrors, which allows multiple server validations errors to be set
    • new propertyName property, that is name of server property that is being validated by this
• RXJS OPERATORS
  • new handle400WithValidations operator, that handles 400 http code with validations as response
  • new handle404 operator, that handles 404 http code as response
  • new handle4xx operator, that handles http error response with code 400..499 as response
• new subpackage @anglr/error-handling/rest
• subpackage @anglr/error-handling/rest
  • requires @anglr/rest minimal version 11.0.1
  • DECORATORS
    • new Handle404 decorator, that handles 404 response http code
    • new IgnoreClientErrors decorator, that adds ignored client error http codes for client error handling middleware
    • new Handle400WithValidations decorator, that handles 400 http code with validations
  • MIDDLEWARES
    • new ClientErrorHandlingMiddleware middleware, that is used for handling 4xx errors
  • new RestHttpClientErrors interface, that contains metadata for http client errors configuration
    • property addIgnoredClientErrors array of ignored client errors that will be added to default ones
    • property clientErrorResponseMapper response mapper for client errors
    • property customErrorHandlers custom error handlers for specific http status codes
  • new WithRestClientContext class, that allows resolving your data with RESTClient context
  • new resolveWithRestClientContext function, that resolves with rest client context into result

BREAKING CHANGES

• removed BadRequestDetail
• removed HTTP_ERROR_INTERCEPTOR_PROVIDER replaced by HTTP_SERVER_ERROR_INTERCEPTOR_PROVIDER and HTTP_CLIENT_ERROR_INTERCEPTOR_PROVIDER
  • HTTP_CLIENT_ERROR_INTERCEPTOR_PROVIDER should not be used, use ClientErrorHandlingMiddleware instead
• removed ResponseMapperFunction
• removed ERROR_RESPONSE_MAP_PROVIDER
• removed HttpErrorInterceptor replaced by HttpClientErrorInterceptor and HttpServerErrorInterceptor
  • HttpClientErrorInterceptor should not be used, use ClientErrorHandlingMiddleware instead
• removed HttpErrorInterceptorOptions
• updated ServerValidationService class serverValidations property, has new type HttpClientValidationErrors
• updated ServerValidationService class addServerValidationErrors method, has new parameter type HttpClientValidationErrors
• removed SERVER_VALIDATIONS constant