@eac-arch/infrastructure-http 1.0.2 → 1.0.6

package/README.md

@@ -1,63 +1,83 @@
-# EacArchInfrastructureHttp
-
-This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 21.1.0.
-
-## Code scaffolding
-
-Angular CLI includes powerful code scaffolding tools. To generate a new component, run:
-
-```bash
-ng generate component component-name
-```
-
-For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run:
-
-```bash
-ng generate --help
-```
-
-## Building
-
-To build the library, run:
-
-```bash
-ng build eac-arch-infrastructure-http
-```
-
-This command will compile your project, and the build artifacts will be placed in the `dist/` directory.
-
-### Publishing the Library
-
-Once the project is built, you can publish your library by following these steps:
-
-1. Navigate to the `dist` directory:
-   ```bash
-   cd dist/eac-arch-infrastructure-http
-   ```
-
-2. Run the `npm publish` command to publish your library to the npm registry:
-   ```bash
-   npm publish
-   ```
-
-## Running unit tests
-
-To execute unit tests with the [Karma](https://karma-runner.github.io) test runner, use the following command:
-
-```bash
-ng test
-```
-
-## Running end-to-end tests
-
-For end-to-end (e2e) testing, run:
-
-```bash
-ng e2e
-```
-
-Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs.
-
-## Additional Resources
-
-For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.
+# @eac-arch/infrastructure-http
+
+Angular infrastructure library for HTTP transport contracts and cross-cutting error handling.
+
+## Purpose
+
+`@eac-arch/infrastructure-http` provides reusable transport primitives aligned with server contracts and ready-to-wire error handling infrastructure.
+
+## Main Capabilities
+
+- `PagedList<T>`
+: Client mirror of server paged list metadata and navigation flags.
+- JSON:API error models
+: Typed `ErrorResponse`/`ErrorObject` for API error payloads.
+- `httpErrorInterceptor`
+: Centralized HTTP error normalization and delegation.
+- `GlobalErrorHandler` + `provideErrorHandling()`
+: Captures non-HTTP runtime errors and routes them to a notification service.
+- `ErrorNotificationService` contract
+: Injection-token based bridge so UI layers decide how to display errors.
+- JSON Patch helpers
+: `JsonPatchOperation`, `UpdatePartialDelta`, and conversion from shared-kernel patch operations.
+
+## Public API
+
+```ts
+export { PagedList };
+export * from './errors';
+export type { JsonPatchOperation, UpdatePartialDelta, UpdatePartialOperation };
+export { toJsonPatchOperations };
+```
+
+## Usage
+
+Register global error handler:
+
+```ts
+import { provideErrorHandling } from '@eac-arch/infrastructure-http';
+
+providers: [provideErrorHandling()]
+```
+
+Provide notification bridge in UI module:
+
+```ts
+{ provide: ERROR_NOTIFICATION_SERVICE, useExisting: MyNotificationService }
+```
+
+## Dependencies
+
+- `@eac-arch/shared-kernel`
+- Angular core/common
+- `tslib`
+
+## Development
+
+From `eac-arch-infrastructure-http`:
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+
+## Created By
+
+**Erick Arostegui Cunza**  
+Enterprise Solutions Architect
+
+Professional Profile:
+- LinkedIn: https://www.linkedin.com/in/erick-arostegui-cunza/
+
+Articles:
+- Medium: https://medium.com/@scorpius86
+
+Channels and Media:
+- Facebook: https://www.facebook.com/Erick.Arostegui.Cunza
+- TikTok: https://www.tiktok.com/@erick_arostegui_cunza
+- Instagram: https://www.instagram.com/erickarosteguicunza/
+- Spotify: https://open.spotify.com/show/2JQxlxcRg7k7cJ1hB52Ge5
+
+Created by Erick Arostegui Cunza.

package/fesm2022/eac-arch-infrastructure-http.mjs

@@ -1,23 +1,154 @@
 import * as i0 from '@angular/core';
-import { Component } from '@angular/core';
-
-class EacArchInfrastructureHttp {
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.5", ngImport: i0, type: EacArchInfrastructureHttp, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "21.1.5", type: EacArchInfrastructureHttp, isStandalone: true, selector: "eac-arch-eac-arch-infrastructure-http", ngImport: i0, template: `
-    <p>
-      eac-arch-infrastructure-http works!
-    </p>
-  `, isInline: true, styles: [""] });
+import { InjectionToken, inject, ErrorHandler, Injectable, makeEnvironmentProviders } from '@angular/core';
+import { HttpErrorResponse } from '@angular/common/http';
+import { catchError, throwError } from 'rxjs';
+
+// Mirrors the server's PagedList<T> (EAC.SharedKernel.Application.Pagination).
+// A read-only collection of items with pagination metadata.
+class PagedList {
+    items;
+    currentPage;
+    totalPages;
+    pageSize;
+    totalCount;
+    get hasPrevious() {
+        return this.currentPage > 1;
+    }
+    get hasNext() {
+        return this.currentPage < this.totalPages;
+    }
+    constructor(items, totalCount, pageNumber, pageSize) {
+        if (pageSize <= 0) {
+            throw new Error('Page size must be greater than 0');
+        }
+        if (pageNumber <= 0) {
+            throw new Error('Page number must be greater than 0');
+        }
+        if (totalCount < 0) {
+            throw new Error('Total count cannot be negative');
+        }
+        this.totalCount = totalCount;
+        this.pageSize = pageSize;
+        this.currentPage = pageNumber;
+        this.totalPages = Math.ceil(totalCount / pageSize);
+        this.items = Object.freeze([...items]);
+    }
+    static empty(pageSize = 10) {
+        return new PagedList([], 0, 1, pageSize);
+    }
+    static create(items, totalCount, pageNumber, pageSize) {
+        return new PagedList(items, totalCount, pageNumber, pageSize);
+    }
+}
+
+const ERROR_NOTIFICATION_SERVICE = new InjectionToken('ErrorNotificationService');
+
+const httpErrorInterceptor = (req, next) => {
+    // Capture in injection context, before any async operation
+    const notificationService = inject(ERROR_NOTIFICATION_SERVICE, { optional: true });
+    return next(req).pipe(catchError((error) => {
+        // Skip if explicitly marked to skip global error handling
+        if (req.headers.has('X-Skip-Global-Error-Handler')) {
+            return throwError(() => error);
+        }
+        if (notificationService) {
+            if (!(error instanceof HttpErrorResponse)) {
+                const unknownError = {
+                    errors: [{
+                            status: '0',
+                            title: 'Unexpected Error',
+                            detail: error instanceof Error
+                                ? error.message
+                                : 'An unexpected error occurred while processing the request.'
+                        }]
+                };
+                notificationService.handleHttpError(unknownError, 0, req.url);
+                return throwError(() => error);
+            }
+            // Network errors (ERR_CONNECTION_REFUSED, ERR_CONNECTION_TIMED_OUT, etc.)
+            // have status 0 and error.error may be null/undefined with withFetch()
+            if (error.status === 0 || !error.error) {
+                const networkError = {
+                    errors: [{
+                            status: '0',
+                            title: 'Connection Error',
+                            detail: 'Could not connect to the server. Please check your connection or try again later.'
+                        }]
+                };
+                notificationService.handleHttpError(networkError, 0, req.url);
+            }
+            else {
+                try {
+                    // Try to parse as JSON:API error response
+                    const errorResponse = error.error;
+                    if (errorResponse.errors && Array.isArray(errorResponse.errors)) {
+                        notificationService.handleHttpError(errorResponse, error.status, req.url);
+                    }
+                    else {
+                        // Not a JSON:API response, create generic error
+                        const genericError = {
+                            errors: [{
+                                    status: error.status.toString(),
+                                    title: error.statusText || 'Error',
+                                    detail: typeof error.error === 'string'
+                                        ? error.error
+                                        : error.message || 'An unexpected error occurred'
+                                }]
+                        };
+                        notificationService.handleHttpError(genericError, error.status, req.url);
+                    }
+                }
+                catch {
+                    const genericError = {
+                        errors: [{
+                                status: error.status.toString(),
+                                title: 'Error',
+                                detail: error.message || 'An unexpected error occurred'
+                            }]
+                    };
+                    notificationService.handleHttpError(genericError, error.status, req.url);
+                }
+            }
+        }
+        return throwError(() => error);
+    }));
+};
+
+class GlobalErrorHandler extends ErrorHandler {
+    // Inject in class field to stay within injection context
+    notificationService = inject(ERROR_NOTIFICATION_SERVICE, { optional: true });
+    handleError(error) {
+        // HTTP errors are already handled by the interceptor
+        if (error instanceof HttpErrorResponse) {
+            super.handleError(error);
+            return;
+        }
+        // Log to console in all environments
+        console.error('Unhandled error:', error);
+        if (this.notificationService) {
+            this.notificationService.handleCoreError(error);
+        }
+        // Call parent to ensure default Angular error handling
+        super.handleError(error);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: GlobalErrorHandler, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: GlobalErrorHandler });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.5", ngImport: i0, type: EacArchInfrastructureHttp, decorators: [{
-            type: Component,
-            args: [{ selector: 'eac-arch-eac-arch-infrastructure-http', imports: [], template: `
-    <p>
-      eac-arch-infrastructure-http works!
-    </p>
-  ` }]
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.3", ngImport: i0, type: GlobalErrorHandler, decorators: [{
+            type: Injectable
         }] });
 
+function provideErrorHandling() {
+    return makeEnvironmentProviders([
+        { provide: ErrorHandler, useClass: GlobalErrorHandler }
+    ]);
+}
+
+// Converts shared-kernel PatchOperation[] to the HTTP transport representation.
+function toJsonPatchOperations(operations) {
+    return operations.map(({ op, path, value, from }) => ({ op, path, value, from }));
+}
+
 /*
  * Public API Surface of eac-arch-infrastructure-http
  */
@@ -26,5 +157,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.5", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { EacArchInfrastructureHttp };
+export { ERROR_NOTIFICATION_SERVICE, PagedList, httpErrorInterceptor, provideErrorHandling, toJsonPatchOperations };
 //# sourceMappingURL=eac-arch-infrastructure-http.mjs.map

package/fesm2022/eac-arch-infrastructure-http.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"eac-arch-infrastructure-http.mjs","sources":["../../../projects/eac-arch-infrastructure-http/src/lib/eac-arch-infrastructure-http.ts","../../../projects/eac-arch-infrastructure-http/src/public-api.ts","../../../projects/eac-arch-infrastructure-http/src/eac-arch-infrastructure-http.ts"],"sourcesContent":["import { Component } from '@angular/core';\r\n\r\n@Component({\r\n  selector: 'eac-arch-eac-arch-infrastructure-http',\r\n  imports: [],\r\n  template: `\r\n    <p>\r\n      eac-arch-infrastructure-http works!\r\n    </p>\r\n  `,\r\n  styles: ``,\r\n})\r\nexport class EacArchInfrastructureHttp {\r\n\r\n}\r\n","/*\r\n * Public API Surface of eac-arch-infrastructure-http\r\n */\r\n\r\nexport * from './lib/eac-arch-infrastructure-http';\r\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;MAYa,yBAAyB,CAAA;uGAAzB,yBAAyB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,SAAA,EAAA,CAAA;AAAzB,IAAA,OAAA,IAAA,GAAA,EAAA,CAAA,oBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,IAAA,EAAA,yBAAyB,EAAA,YAAA,EAAA,IAAA,EAAA,QAAA,EAAA,uCAAA,EAAA,QAAA,EAAA,EAAA,EAAA,QAAA,EAP1B,CAAA;;;;AAIT,EAAA,CAAA,EAAA,QAAA,EAAA,IAAA,EAAA,MAAA,EAAA,CAAA,EAAA,CAAA,EAAA,CAAA;;2FAGU,yBAAyB,EAAA,UAAA,EAAA,CAAA;kBAVrC,SAAS;+BACE,uCAAuC,EAAA,OAAA,EACxC,EAAE,EAAA,QAAA,EACD,CAAA;;;;AAIT,EAAA,CAAA,EAAA;;;ACTH;;AAEG;;ACFH;;AAEG;;;;"}
+{"version":3,"file":"eac-arch-infrastructure-http.mjs","sources":["../../../projects/eac-arch-infrastructure-http/src/lib/pagination/paged-list.ts","../../../projects/eac-arch-infrastructure-http/src/lib/errors/error-notification.service.interface.ts","../../../projects/eac-arch-infrastructure-http/src/lib/errors/http-error.interceptor.ts","../../../projects/eac-arch-infrastructure-http/src/lib/errors/global-error.handler.ts","../../../projects/eac-arch-infrastructure-http/src/lib/errors/provide-error-handling.ts","../../../projects/eac-arch-infrastructure-http/src/lib/patch/patch.models.ts","../../../projects/eac-arch-infrastructure-http/src/public-api.ts","../../../projects/eac-arch-infrastructure-http/src/eac-arch-infrastructure-http.ts"],"sourcesContent":["// Mirrors the server's PagedList<T> (EAC.SharedKernel.Application.Pagination).\n// A read-only collection of items with pagination metadata.\nexport class PagedList<T> {\n  readonly items: readonly T[];\n  readonly currentPage: number;\n  readonly totalPages: number;\n  readonly pageSize: number;\n  readonly totalCount: number;\n\n  get hasPrevious(): boolean {\n    return this.currentPage > 1;\n  }\n\n  get hasNext(): boolean {\n    return this.currentPage < this.totalPages;\n  }\n\n  private constructor(items: T[], totalCount: number, pageNumber: number, pageSize: number) {\n    if (pageSize <= 0) {\n      throw new Error('Page size must be greater than 0');\n    }\n    if (pageNumber <= 0) {\n      throw new Error('Page number must be greater than 0');\n    }\n    if (totalCount < 0) {\n      throw new Error('Total count cannot be negative');\n    }\n\n    this.totalCount = totalCount;\n    this.pageSize = pageSize;\n    this.currentPage = pageNumber;\n    this.totalPages = Math.ceil(totalCount / pageSize);\n    this.items = Object.freeze([...items]);\n  }\n\n  static empty<T>(pageSize = 10): PagedList<T> {\n    return new PagedList<T>([], 0, 1, pageSize);\n  }\n\n  static create<T>(items: T[], totalCount: number, pageNumber: number, pageSize: number): PagedList<T> {\n    return new PagedList(items, totalCount, pageNumber, pageSize);\n  }\n}\n","import { InjectionToken } from '@angular/core';\nimport type { ErrorResponse } from './models/json-api-error.models';\n\nexport interface ErrorNotificationService {\n  handleHttpError(errorResponse: ErrorResponse, statusCode: number, requestUrl?: string): void;\n  handleCoreError(error: Error): void;\n}\n\nexport const ERROR_NOTIFICATION_SERVICE = new InjectionToken<ErrorNotificationService>('ErrorNotificationService');\n","import { HttpErrorResponse, HttpInterceptorFn } from '@angular/common/http';\nimport { inject } from '@angular/core';\nimport { catchError, throwError } from 'rxjs';\nimport type { ErrorResponse } from './models/json-api-error.models';\nimport { ErrorNotificationService, ERROR_NOTIFICATION_SERVICE } from './error-notification.service.interface';\n\nexport const httpErrorInterceptor: HttpInterceptorFn = (req, next) => {\n  // Capture in injection context, before any async operation\n  const notificationService = inject(ERROR_NOTIFICATION_SERVICE, { optional: true });\n\n  return next(req).pipe(\n    catchError((error: unknown) => {\n      // Skip if explicitly marked to skip global error handling\n      if (req.headers.has('X-Skip-Global-Error-Handler')) {\n        return throwError(() => error);\n      }\n\n      if (notificationService) {\n        if (!(error instanceof HttpErrorResponse)) {\n          const unknownError: ErrorResponse = {\n            errors: [{\n              status: '0',\n              title: 'Unexpected Error',\n              detail: error instanceof Error\n                ? error.message\n                : 'An unexpected error occurred while processing the request.'\n            }]\n          };\n          notificationService.handleHttpError(unknownError, 0, req.url);\n          return throwError(() => error);\n        }\n\n        // Network errors (ERR_CONNECTION_REFUSED, ERR_CONNECTION_TIMED_OUT, etc.)\n        // have status 0 and error.error may be null/undefined with withFetch()\n        if (error.status === 0 || !error.error) {\n          const networkError: ErrorResponse = {\n            errors: [{\n              status: '0',\n              title: 'Connection Error',\n              detail: 'Could not connect to the server. Please check your connection or try again later.'\n            }]\n          };\n          notificationService.handleHttpError(networkError, 0, req.url);\n        } else {\n          try {\n            // Try to parse as JSON:API error response\n            const errorResponse = error.error as ErrorResponse;\n            if (errorResponse.errors && Array.isArray(errorResponse.errors)) {\n              notificationService.handleHttpError(errorResponse, error.status, req.url);\n            } else {\n              // Not a JSON:API response, create generic error\n              const genericError: ErrorResponse = {\n                errors: [{\n                  status: error.status.toString(),\n                  title: error.statusText || 'Error',\n                  detail: typeof error.error === 'string'\n                    ? error.error\n                    : error.message || 'An unexpected error occurred'\n                }]\n              };\n              notificationService.handleHttpError(genericError, error.status, req.url);\n            }\n          } catch {\n            const genericError: ErrorResponse = {\n              errors: [{\n                status: error.status.toString(),\n                title: 'Error',\n                detail: error.message || 'An unexpected error occurred'\n              }]\n            };\n            notificationService.handleHttpError(genericError, error.status, req.url);\n          }\n        }\n      }\n\n      return throwError(() => error);\n    })\n  );\n};\n","import { ErrorHandler, inject, Injectable } from '@angular/core';\nimport { HttpErrorResponse } from '@angular/common/http';\nimport { ERROR_NOTIFICATION_SERVICE } from './error-notification.service.interface';\n\n@Injectable()\nexport class GlobalErrorHandler extends ErrorHandler {\n  // Inject in class field to stay within injection context\n  private readonly notificationService = inject(ERROR_NOTIFICATION_SERVICE, { optional: true });\n\n  override handleError(error: Error | HttpErrorResponse): void {\n    // HTTP errors are already handled by the interceptor\n    if (error instanceof HttpErrorResponse) {\n      super.handleError(error);\n      return;\n    }\n\n    // Log to console in all environments\n    console.error('Unhandled error:', error);\n\n    if (this.notificationService) {\n      this.notificationService.handleCoreError(error);\n    }\n\n    // Call parent to ensure default Angular error handling\n    super.handleError(error);\n  }\n}\n","import { EnvironmentProviders, ErrorHandler, makeEnvironmentProviders } from '@angular/core';\nimport { GlobalErrorHandler } from './global-error.handler';\n\nexport function provideErrorHandling(): EnvironmentProviders {\n  return makeEnvironmentProviders([\n    { provide: ErrorHandler, useClass: GlobalErrorHandler }\n  ]);\n}\n","import type { PatchOperation } from '@eac-arch/shared-kernel';\n\n// Represents a single JSON Patch operation as defined in RFC 6902.\n// Used as the body for HTTP PATCH requests with Content-Type: application/json-patch+json.\nexport interface JsonPatchOperation {\n  readonly op: 'add' | 'remove' | 'replace' | 'move' | 'copy' | 'test';\n  readonly path: string;\n  readonly from?: string;\n  readonly value?: unknown;\n}\n\n// Mirrors the server's UpdatePartialDelta (EAC.SharedKernel.Utils.UpdatePartialDelta).\n// Carries the entity ID and a list of field-level operations.\nexport interface UpdatePartialDelta {\n  readonly entityId: string;\n  readonly operations: readonly UpdatePartialOperation[];\n}\n\n// Mirrors the server's UpdatePartialOperation (EAC.SharedKernel.Utils.UpdatePartial.UpdatePartialOperation).\nexport interface UpdatePartialOperation {\n  readonly op: string;\n  readonly path: string;\n  readonly value?: unknown;\n}\n\n// Converts shared-kernel PatchOperation[] to the HTTP transport representation.\nexport function toJsonPatchOperations(operations: PatchOperation[]): JsonPatchOperation[] {\n  return operations.map(({ op, path, value, from }) => ({ op, path, value, from }));\n}\n","/*\n * Public API Surface of eac-arch-infrastructure-http\n */\n\nexport { PagedList } from './lib/pagination';\nexport * from './lib/errors';\nexport type { JsonPatchOperation, UpdatePartialDelta, UpdatePartialOperation } from './lib/patch';\nexport { toJsonPatchOperations } from './lib/patch';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@eac-arch/infrastructure-http",
-  "version": "1.0.2",
+  "version": "1.0.6",
   "peerDependencies": {
     "@angular/common": "^21.1.0",
     "@angular/core": "^21.1.0"
   },
   "dependencies": {
+    "@eac-arch/shared-kernel": "1.0.6",
     "tslib": "^2.3.0"
   },
   "sideEffects": false,
@@ -20,4 +21,4 @@
       "default": "./fesm2022/eac-arch-infrastructure-http.mjs"
     }
   }
-}
+}

package/types/eac-arch-infrastructure-http.d.ts

@@ -1,8 +1,74 @@
-import * as i0 from '@angular/core';
+import { InjectionToken, EnvironmentProviders } from '@angular/core';
+import { HttpInterceptorFn } from '@angular/common/http';
+import { PatchOperation } from '@eac-arch/shared-kernel';
 
-declare class EacArchInfrastructureHttp {
-    static ɵfac: i0.ɵɵFactoryDeclaration<EacArchInfrastructureHttp, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<EacArchInfrastructureHttp, "eac-arch-eac-arch-infrastructure-http", never, {}, {}, never, never, true, never>;
+declare class PagedList<T> {
+    readonly items: readonly T[];
+    readonly currentPage: number;
+    readonly totalPages: number;
+    readonly pageSize: number;
+    readonly totalCount: number;
+    get hasPrevious(): boolean;
+    get hasNext(): boolean;
+    private constructor();
+    static empty<T>(pageSize?: number): PagedList<T>;
+    static create<T>(items: T[], totalCount: number, pageNumber: number, pageSize: number): PagedList<T>;
 }
 
-export { EacArchInfrastructureHttp };
+interface ErrorObject {
+    id?: string;
+    links?: ErrorLinks;
+    status: string;
+    code?: string;
+    title: string;
+    detail?: string;
+    source?: ErrorSource;
+    meta?: Record<string, unknown>;
+}
+interface ErrorLinks {
+    about?: string;
+    type?: string;
+}
+interface ErrorSource {
+    pointer?: string;
+    parameter?: string;
+    header?: string;
+}
+interface ErrorResponse {
+    errors: ErrorObject[];
+    meta?: Record<string, unknown>;
+    jsonapi?: ApiInfo;
+}
+interface ApiInfo {
+    version: string;
+}
+
+interface ErrorNotificationService {
+    handleHttpError(errorResponse: ErrorResponse, statusCode: number, requestUrl?: string): void;
+    handleCoreError(error: Error): void;
+}
+declare const ERROR_NOTIFICATION_SERVICE: InjectionToken<ErrorNotificationService>;
+
+declare const httpErrorInterceptor: HttpInterceptorFn;
+
+declare function provideErrorHandling(): EnvironmentProviders;
+
+interface JsonPatchOperation {
+    readonly op: 'add' | 'remove' | 'replace' | 'move' | 'copy' | 'test';
+    readonly path: string;
+    readonly from?: string;
+    readonly value?: unknown;
+}
+interface UpdatePartialDelta {
+    readonly entityId: string;
+    readonly operations: readonly UpdatePartialOperation[];
+}
+interface UpdatePartialOperation {
+    readonly op: string;
+    readonly path: string;
+    readonly value?: unknown;
+}
+declare function toJsonPatchOperations(operations: PatchOperation[]): JsonPatchOperation[];
+
+export { ERROR_NOTIFICATION_SERVICE, PagedList, httpErrorInterceptor, provideErrorHandling, toJsonPatchOperations };
+export type { ApiInfo, ErrorLinks, ErrorNotificationService, ErrorObject, ErrorResponse, ErrorSource, JsonPatchOperation, UpdatePartialDelta, UpdatePartialOperation };