@intellegens/cornerstone-client-angular 0.0.45

package/README.md

@@ -0,0 +1,253 @@
+# @intellegens/cornerstone-client-angular
+
+Angular integration package for Cornerstone API clients. This package provides Angular-specific HTTP service implementation and utilities for integration with Angular applications.
+
+## Installation
+
+```bash
+npm install @intellegens/cornerstone-client-angular
+```
+
+## Quick Start
+
+### 1. Basic Setup
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { HttpClient } from '@angular/common/http';
+import { ApiReadControllerClient, AngularHttpService, apiInitializationService } from '@intellegens/cornerstone-client-angular';
+
+@Component({
+  selector: 'app-users',
+  template: `<div>{{ users | json }}</div>`,
+})
+export class UsersComponent {
+  private httpClient = inject(HttpClient);
+  private angularHttpService = new AngularHttpService(this.httpClient);
+
+  users$ = this.loadUsers();
+
+  private async loadUsers() {
+    // Initialize with Angular HTTP service
+    await apiInitializationService.initialize({
+      httpService: this.angularHttpService,
+    });
+
+    const client = new ApiReadControllerClient('/api/users');
+    return await client.readAll();
+  }
+}
+```
+
+### 2. Service-Based Approach (Recommended)
+
+Create an Angular service for better dependency injection:
+
+```typescript
+import { Injectable, inject } from '@angular/core';
+import { HttpClient } from '@angular/common/http';
+import {
+  AngularHttpService,
+  ApiReadControllerClient,
+  ApiCrudControllerClient,
+  UserManagementControllerClient,
+  apiInitializationService,
+} from '@intellegens/cornerstone-client-angular';
+
+@Injectable({
+  providedIn: 'root',
+})
+export class ApiService {
+  private httpClient = inject(HttpClient);
+  private angularHttpService = new AngularHttpService(this.httpClient);
+
+  constructor() {
+    this.initializeApi();
+  }
+
+  private async initializeApi() {
+    await apiInitializationService.initialize({
+      httpService: this.angularHttpService,
+    });
+  }
+
+  // Create typed client methods
+  getUsersClient() {
+    return new ApiReadControllerClient('/api/users', this.angularHttpService);
+  }
+
+  getUserManagementClient() {
+    return new UserManagementControllerClient('/api/auth', this.angularHttpService);
+  }
+
+  getProductsClient() {
+    return new ApiCrudControllerClient('/api/products', this.angularHttpService);
+  }
+}
+```
+
+### 3. Using in Components
+
+```typescript
+import { Component, inject, OnInit } from '@angular/core';
+import { ApiService } from './api.service';
+
+@Component({
+  selector: 'app-dashboard',
+  template: `
+    <div>
+      <h2>Users</h2>
+      <ul>
+        <li *ngFor="let user of users">{{ user.name }}</li>
+      </ul>
+
+      <h2>Products</h2>
+      <ul>
+        <li *ngFor="let product of products">{{ product.title }}</li>
+      </ul>
+    </div>
+  `,
+})
+export class DashboardComponent implements OnInit {
+  private apiService = inject(ApiService);
+
+  users: any[] = [];
+  products: any[] = [];
+
+  async ngOnInit() {
+    // Load users
+    const usersClient = this.apiService.getUsersClient();
+    this.users = await usersClient.readAll();
+
+    // Load products
+    const productsClient = this.apiService.getProductsClient();
+    this.products = await productsClient.readAll();
+  }
+
+  async createProduct(productData: any) {
+    const productsClient = this.apiService.getProductsClient();
+    const newProduct = await productsClient.create(productData);
+    this.products.push(newProduct);
+  }
+}
+```
+
+## Advanced Features
+
+### Request Cancellation with AbortSignal
+
+Angular components can cancel requests when destroyed:
+
+```typescript
+import { Component, inject, OnDestroy } from '@angular/core';
+import { ApiService } from './api.service';
+
+@Component({
+  selector: 'app-users-list',
+  template: `<div>{{ users | json }}</div>`,
+})
+export class UsersListComponent implements OnDestroy {
+  private apiService = inject(ApiService);
+  private abortController = new AbortController();
+
+  users: any[] = [];
+
+  async ngOnInit() {
+    try {
+      const client = this.apiService.getUsersClient();
+      this.users = await client.readAll(this.abortController.signal);
+    } catch (error) {
+      if (error.name === 'AbortError') {
+        console.log('Request was cancelled');
+      }
+    }
+  }
+
+  ngOnDestroy() {
+    // Cancel any pending requests
+    this.abortController.abort();
+  }
+}
+```
+
+### Custom HTTP Configuration
+
+Configure the Angular HttpClient with interceptors and custom settings:
+
+```typescript
+import { Injectable, inject } from '@angular/core';
+import { HttpClient, HttpInterceptor, HttpRequest, HttpHandler } from '@angular/common/http';
+import { AngularHttpService } from '@intellegens/cornerstone-client-angular';
+
+// Custom interceptor for authentication
+@Injectable()
+export class AuthInterceptor implements HttpInterceptor {
+  intercept(req: HttpRequest<any>, next: HttpHandler) {
+    const authReq = req.clone({
+      setHeaders: {
+        Authorization: `Bearer ${localStorage.getItem('token')}`,
+      },
+    });
+    return next.handle(authReq);
+  }
+}
+
+// Service with configured HTTP client
+@Injectable({
+  providedIn: 'root',
+})
+export class ConfiguredApiService {
+  private httpClient = inject(HttpClient);
+  private angularHttpService = new AngularHttpService(this.httpClient);
+
+  // The HttpClient will automatically use registered interceptors
+  getUsersClient() {
+    return new ApiReadControllerClient('/api/users', this.angularHttpService);
+  }
+}
+```
+
+### Error Handling
+
+Handle HTTP errors with Angular's error handling patterns:
+
+```typescript
+import { Component, inject } from '@angular/core';
+import { catchError, of } from 'rxjs';
+import { ApiService } from './api.service';
+
+@Component({
+  selector: 'app-error-handling',
+  template: `<div>{{ errorMessage || 'Loading...' }}</div>`,
+})
+export class ErrorHandlingComponent {
+  private apiService = inject(ApiService);
+
+  errorMessage: string = '';
+
+  async loadData() {
+    try {
+      const client = this.apiService.getUsersClient();
+      const users = await client.readAll();
+      console.log('Users loaded:', users);
+    } catch (error: any) {
+      this.errorMessage = `Failed to load users: ${error.message}`;
+      console.error('API Error:', error);
+    }
+  }
+}
+```
+
+## API Reference
+
+### AngularHttpService
+
+The `AngularHttpService` class implements the `IHttpService` interface using Angular's `HttpClient`.
+
+```typescript
+class AngularHttpService implements IHttpService {
+  constructor(private httpClient: HttpClient) {}
+
+  async request<T = any>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+}
+```

package/fesm2022/intellegens-cornerstone-client-angular.mjs

@@ -0,0 +1,110 @@
+import { fromEvent, switchMap, throwError, race, firstValueFrom } from 'rxjs';
+export * from '@intellegens/cornerstone-client';
+
+// Ignore eslint any error in this file
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Angular HttpClient-based HTTP service implementation
+ */
+class AngularHttpService {
+    httpClient;
+    constructor(httpClient) {
+        if (!httpClient) {
+            throw new Error('Angular HttpClient instance is required');
+        }
+        this.httpClient = httpClient;
+    }
+    async requestAsync(url, config) {
+        try {
+            const method = config?.method || 'GET';
+            const headers = config?.headers || {};
+            const body = config?.body;
+            const withCredentials = config?.credentials === 'include';
+            const options = {
+                headers,
+                withCredentials,
+                observe: 'response',
+                responseType: 'json',
+            };
+            let request;
+            switch (method.toUpperCase()) {
+                case 'GET':
+                    request = this.httpClient.get(url, options);
+                    break;
+                case 'POST':
+                    request = this.httpClient.post(url, body ? JSON.parse(body) : null, options);
+                    break;
+                case 'PUT':
+                    request = this.httpClient.put(url, body ? JSON.parse(body) : null, options);
+                    break;
+                case 'DELETE':
+                    request = this.httpClient.delete(url, options);
+                    break;
+                case 'PATCH':
+                    request = this.httpClient.patch(url, body ? JSON.parse(body) : null, options);
+                    break;
+                default:
+                    throw new Error(`Unsupported HTTP method: ${method}`);
+            }
+            // Handle cancellation using AbortSignal
+            if (config?.signal) {
+                // Check if signal is already aborted
+                if (config.signal.aborted) {
+                    throw new Error('Request was aborted');
+                }
+                const abort$ = fromEvent(config.signal, 'abort').pipe(switchMap(() => throwError(() => new Error('Request was aborted'))));
+                request = race(request, abort$);
+            }
+            const response = (await firstValueFrom(request));
+            // Convert Angular HttpResponse headers to plain object
+            const responseHeaders = {};
+            if (response.headers) {
+                response.headers.keys().forEach((key) => {
+                    responseHeaders[key] = response.headers.get(key);
+                });
+            }
+            return {
+                ok: response.status >= 200 && response.status < 300,
+                status: response.status,
+                statusText: response.statusText || 'OK',
+                headers: responseHeaders,
+                json: async () => response.body,
+                text: async () => (typeof response.body === 'string' ? response.body : JSON.stringify(response.body)),
+            };
+        }
+        catch (error) {
+            if (error.status !== undefined) {
+                // Angular HttpErrorResponse
+                const errorHeaders = {};
+                if (error.headers) {
+                    error.headers.keys().forEach((key) => {
+                        errorHeaders[key] = error.headers.get(key);
+                    });
+                }
+                return {
+                    ok: false,
+                    status: error.status,
+                    statusText: error.statusText || 'Error',
+                    headers: errorHeaders,
+                    json: async () => error.error,
+                    text: async () => (typeof error.error === 'string' ? error.error : JSON.stringify(error.error)),
+                };
+            }
+            else {
+                // Other errors
+                throw error;
+            }
+        }
+    }
+}
+
+/*
+ * Public API Surface of cornerstone-client-angular
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { AngularHttpService };
+//# sourceMappingURL=intellegens-cornerstone-client-angular.mjs.map

package/fesm2022/intellegens-cornerstone-client-angular.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"intellegens-cornerstone-client-angular.mjs","sources":["../../../../projects/intellegens/cornerstone-client-angular/src/lib/services/AngularHttpService/index.ts","../../../../projects/intellegens/cornerstone-client-angular/src/public-api.ts","../../../../projects/intellegens/cornerstone-client-angular/src/intellegens-cornerstone-client-angular.ts"],"sourcesContent":["// Ignore eslint any error in this file\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport { IHttpService, HttpRequestConfig, HttpResponse } from '@intellegens/cornerstone-client';\nimport { HttpClient } from '@angular/common/http';\nimport { firstValueFrom, fromEvent, throwError, switchMap, race } from 'rxjs';\n\n/**\n * Angular HttpClient-based HTTP service implementation\n */\nexport class AngularHttpService implements IHttpService {\n  private httpClient: HttpClient;\n\n  constructor(httpClient: HttpClient) {\n    if (!httpClient) {\n      throw new Error('Angular HttpClient instance is required');\n    }\n    this.httpClient = httpClient;\n  }\n\n  public async requestAsync<T = any>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>> {\n    try {\n      const method = config?.method || 'GET';\n      const headers = config?.headers || {};\n      const body = config?.body;\n      const withCredentials = config?.credentials === 'include';\n\n      const options = {\n        headers,\n        withCredentials,\n        observe: 'response' as const,\n        responseType: 'json' as const,\n      };\n\n      let request: any;\n\n      switch (method.toUpperCase()) {\n        case 'GET':\n          request = this.httpClient.get(url, options);\n          break;\n        case 'POST':\n          request = this.httpClient.post(url, body ? JSON.parse(body) : null, options);\n          break;\n        case 'PUT':\n          request = this.httpClient.put(url, body ? JSON.parse(body) : null, options);\n          break;\n        case 'DELETE':\n          request = this.httpClient.delete(url, options);\n          break;\n        case 'PATCH':\n          request = this.httpClient.patch(url, body ? JSON.parse(body) : null, options);\n          break;\n        default:\n          throw new Error(`Unsupported HTTP method: ${method}`);\n      }\n\n      // Handle cancellation using AbortSignal\n      if (config?.signal) {\n        // Check if signal is already aborted\n        if (config.signal.aborted) {\n          throw new Error('Request was aborted');\n        }\n\n        const abort$ = fromEvent(config.signal, 'abort').pipe(switchMap(() => throwError(() => new Error('Request was aborted'))));\n\n        request = race(request, abort$);\n      }\n\n      const response = (await firstValueFrom(request)) as any;\n\n      // Convert Angular HttpResponse headers to plain object\n      const responseHeaders: Record<string, string> = {};\n      if (response.headers) {\n        response.headers.keys().forEach((key: string) => {\n          responseHeaders[key] = response.headers.get(key);\n        });\n      }\n\n      return {\n        ok: response.status >= 200 && response.status < 300,\n        status: response.status,\n        statusText: response.statusText || 'OK',\n        headers: responseHeaders,\n        json: async () => response.body,\n        text: async () => (typeof response.body === 'string' ? response.body : JSON.stringify(response.body)),\n      };\n    } catch (error: any) {\n      if (error.status !== undefined) {\n        // Angular HttpErrorResponse\n        const errorHeaders: Record<string, string> = {};\n        if (error.headers) {\n          error.headers.keys().forEach((key: string) => {\n            errorHeaders[key] = error.headers.get(key);\n          });\n        }\n\n        return {\n          ok: false,\n          status: error.status,\n          statusText: error.statusText || 'Error',\n          headers: errorHeaders,\n          json: async () => error.error,\n          text: async () => (typeof error.error === 'string' ? error.error : JSON.stringify(error.error)),\n        };\n      } else {\n        // Other errors\n        throw error;\n      }\n    }\n  }\n}\n","/*\n * Public API Surface of cornerstone-client-angular\n */\n\nexport * from './lib/';\nexport * from '@intellegens/cornerstone-client';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,14 @@
+import { IHttpService, HttpRequestConfig, HttpResponse } from '@intellegens/cornerstone-client';
+export * from '@intellegens/cornerstone-client';
+import { HttpClient } from '@angular/common/http';
+
+/**
+ * Angular HttpClient-based HTTP service implementation
+ */
+declare class AngularHttpService implements IHttpService {
+    private httpClient;
+    constructor(httpClient: HttpClient);
+    requestAsync<T = any>(url: string, config?: HttpRequestConfig): Promise<HttpResponse<T>>;
+}
+
+export { AngularHttpService };

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@intellegens/cornerstone-client-angular",
+  "version": "0.0.45",
+  "private": false,
+  "publishable": true,
+  "sideEffects": false,
+  "module": "fesm2022/intellegens-cornerstone-client-angular.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/intellegens-cornerstone-client-angular.mjs"
+    }
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}