@vmelou/jsonapi-angular 0.4.0

package/README.md

@@ -0,0 +1,319 @@
+# @vmelou/jsonapi-angular
+
+[![npm version](https://img.shields.io/npm/v/@vmelou/jsonapi-angular)](https://www.npmjs.com/package/@vmelou/jsonapi-angular)
+[![License: MIT](https://img.shields.io/npm/l/@vmelou/jsonapi-angular)](https://opensource.org/licenses/MIT)
+
+Angular integration for [@vmelou/jsonapi](../core/README.md) library. Provides mixins for easy integration with Angular's HttpClient and RxJS for JSON:API endpoints.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Features](#features)
+- [Usage](#usage)
+  - [Basic Setup](#basic-setup)
+  - [Using Mixins](#using-mixins)
+  - [Handling Relationships](#handling-relationships)
+  - [Error Handling](#error-handling)
+- [API Reference](#api-reference)
+- [Examples](#examples)
+- [Contributing](#contributing)
+- [Changelog](#changelog)
+- [License](#license)
+
+## Installation
+
+```bash
+npm install @vmelou/jsonapi @vmelou/jsonapi-angular
+# or
+yarn add @vmelou/jsonapi @vmelou/jsonapi-angular
+```
+
+## Features
+
+- Complete integration with Angular's HttpClient
+- RxJS Observables for all API operations
+- Support for CRUD operations (Create, Read, Update, Delete)
+- List operations with pagination and filtering
+- Error handling with JSON:API error objects
+- TypeScript type safety
+
+## Usage
+
+### Basic Setup
+
+First, define your models using the core library's decorators:
+
+```typescript
+import { BaseResource, JsonResource, JsonAttribute } from '@vmelou/jsonapi';
+
+@JsonResource('authors')
+export class Author extends BaseResource {
+  @JsonAttribute()
+  name = '';
+
+  @JsonAttribute(Date, 'created-at')
+  createdAt: Date = new Date();
+}
+```
+
+### Using Mixins
+
+Create a service that uses the provided mixins through composition:
+
+```typescript
+import { Injectable } from '@angular/core';
+import { HttpClient } from '@angular/common/http';
+import { CreateMixin, RetrieveMixin, UpdateMixin, DeleteMixin, ListMixin } from '@vmelou/jsonapi-angular';
+import { Observable } from 'rxjs';
+import { Author } from './author.model';
+
+@Injectable({ providedIn: 'root' })
+export class AuthorService {
+  private createMixin: CreateMixin<Author>;
+  private retrieveMixin: RetrieveMixin<Author>;
+  private updateMixin: UpdateMixin<Author>;
+  private deleteMixin: DeleteMixin<Author>;
+  private listMixin: ListMixin<Author>;
+  private endpoint = 'authors';
+
+  constructor(http: HttpClient) {
+    this.createMixin = new CreateMixin<Author>(http, this.endpoint, Author);
+    this.retrieveMixin = new RetrieveMixin<Author>(http, this.endpoint, Author);
+    this.updateMixin = new UpdateMixin<Author>(http, this.endpoint, Author);
+    this.deleteMixin = new DeleteMixin<Author>(http, this.endpoint, Author);
+    this.listMixin = new ListMixin<Author>(http, this.endpoint, Author);
+  }
+
+  list(query?: { [key: string]: string }): Observable<Results<Author>> {
+    return this.listMixin.list(query);
+  }
+
+  create(data: Partial<Author>): Observable<Author> {
+    return this.createMixin.create(data);
+  }
+
+  retrieve(id: string, include: string[] = []): Observable<Author> {
+    return this.retrieveMixin.retrieve(id, include);
+  }
+
+  update(id: string, data: Partial<Author>): Observable<Author> {
+    return this.updateMixin.update(id, data);
+  }
+
+  delete(id: string): Observable<void> {
+    return this.deleteMixin.delete(id);
+  }
+
+  // Custom endpoint example
+  retrieveProfile(id: string): Observable<Author> {
+    return this.retrieveMixin.retrieve(`${id}/profile`);
+  }
+}
+```
+
+Now you can use the service in your components:
+
+```typescript
+@Component({
+  selector: 'app-authors',
+  template: `
+    <div *ngFor="let author of authors$ | async">
+      {{ author.name }}
+    </div>
+  `,
+})
+export class AuthorsComponent {
+  authors$ = this.authorService.list();
+
+  constructor(private authorService: AuthorService) {}
+}
+```
+
+### Handling Relationships
+
+The mixins automatically handle relationships defined in your models:
+
+```typescript
+@JsonResource('books')
+export class Book extends BaseResource {
+  @JsonAttribute()
+  title = '';
+
+  @JsonAttribute(Author)
+  author?: Author;
+
+  @JsonAttribute(Author, 'co-authors')
+  coAuthors: Author[] = [];
+}
+
+@Injectable({ providedIn: 'root' })
+export class BookService {
+  private retrieveMixin: RetrieveMixin<Book>;
+  private endpoint = 'books';
+
+  constructor(http: HttpClient) {
+    this.retrieveMixin = new RetrieveMixin<Book>(http, this.endpoint, Book);
+  }
+
+  getBookWithAuthor(id: string): Observable<Book> {
+    return this.retrieveMixin.retrieve(id, ['author', 'co-authors']);
+  }
+
+  // Custom endpoint example
+  getBookReviews(id: string): Observable<Book> {
+    return this.retrieveMixin.retrieve(`${id}/reviews`);
+  }
+}
+```
+
+### Error Handling
+
+All mixins include built-in error handling that converts JSON:API error responses to ApiError objects:
+
+```typescript
+this.bookService.create(newBook).subscribe({
+  next: (book) => console.log('Book created:', book),
+  error: (errors: ApiError[]) => {
+    errors.forEach((error) => {
+      console.error(`Error: ${error.title} - ${error.detail}`);
+    });
+  },
+});
+```
+
+## API Reference
+
+### Mixins
+
+- `ListMixin<T>`: List resources with pagination and filtering
+
+  - `list(query?: { [key: string]: string }, url?: string): Observable<Results<T>>`
+
+- `CreateMixin<T>`: Create new resources
+
+  - `create(data: Partial<T>): Observable<T>`
+
+- `RetrieveMixin<T>`: Retrieve single resources
+
+  - `retrieve(id: string, include: string[] = []): Observable<T>`
+
+- `UpdateMixin<T>`: Update existing resources
+
+  - `update(id: string, data: Partial<T>): Observable<T>`
+
+- `DeleteMixin<T>`: Delete resources
+  - `delete(id: string): Observable<void>`
+
+### Query Parameters
+
+The `list` method supports various query parameters:
+
+```typescript
+// Pagination
+service.list({ 'page[number]': '1', 'page[size]': '10' });
+
+// Filtering
+service.list({ 'filter[name]': 'John' });
+
+// Including relationships
+service.list({ include: 'author,co-authors' });
+
+// Sorting
+service.list({ sort: '-created-at,name' });
+```
+
+## Examples
+
+### Complete CRUD Example
+
+```typescript
+@Component({
+  template: `
+    <div *ngFor="let book of books$ | async">
+      <h2>{{ book.title }}</h2>
+      <p>Author: {{ book.author?.name }}</p>
+      <button (click)="updateBook(book)">Edit</button>
+      <button (click)="deleteBook(book)">Delete</button>
+    </div>
+  `,
+})
+export class BooksComponent {
+  books$ = this.bookService.list();
+
+  constructor(private bookService: BookService) {}
+
+  createBook(bookData: Partial<Book>) {
+    this.bookService.create(bookData).subscribe({
+      next: (book) => console.log('Book created:', book),
+      error: (errors) => console.error('Failed to create book:', errors),
+    });
+  }
+
+  updateBook(book: Book) {
+    this.bookService.update(book.id, { title: 'Updated Title' }).subscribe({
+      next: (updated) => console.log('Book updated:', updated),
+      error: (errors) => console.error('Failed to update book:', errors),
+    });
+  }
+
+  deleteBook(book: Book) {
+    this.bookService.delete(book.id).subscribe({
+      next: () => console.log('Book deleted'),
+      error: (errors) => console.error('Failed to delete book:', errors),
+    });
+  }
+}
+```
+
+### Handling Pagination Results
+
+```typescript
+interface PaginationMeta {
+  pagination: {
+    count: number;
+    page: number;
+    pages: number;
+  };
+}
+
+@Component({
+  template: `
+    <div *ngIf="results$ | async as results">
+      <div *ngFor="let item of results.data">
+        {{ item.title }}
+      </div>
+
+      <div class="pagination">
+        <button [disabled]="!results.links?.prev" (click)="loadPage(results.links?.prev)">Previous</button>
+        <span>Page {{ results.meta?.pagination?.page }} of {{ results.meta?.pagination?.pages }}</span>
+        <button [disabled]="!results.links?.next" (click)="loadPage(results.links?.next)">Next</button>
+      </div>
+    </div>
+  `,
+})
+export class PaginatedListComponent {
+  results$: Observable<Results<Book>>;
+
+  constructor(private bookService: BookService) {
+    this.results$ = this.bookService.list({ 'page[size]': '10' });
+  }
+
+  loadPage(url: string | null) {
+    if (url) {
+      this.results$ = this.bookService.list({}, url);
+    }
+  }
+}
+```
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guidelines](../../../CONTRIBUTING.md) for more details on how to get involved.
+
+## Changelog
+
+Detailed changes for each release are documented in the [CHANGELOG.md](../../../CHANGELOG.md) file.
+
+## License
+
+MIT

package/fesm2022/vmelou-jsonapi-angular.mjs

@@ -0,0 +1,144 @@
+import { throwError, map, catchError } from 'rxjs';
+import { ApiError, serialize, deserialize, deserializeCollection } from '@vmelou/jsonapi';
+import { HttpParams } from '@angular/common/http';
+
+class BaseMixin {
+    handleErrors(error
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    ) {
+        let errors = [];
+        if (error.error instanceof ProgressEvent ||
+            error.error instanceof ErrorEvent ||
+            error.error instanceof TypeError) {
+            // A client-side or network error occurred. Handle it accordingly.
+            const httpError = new ApiError('', error.message, '0');
+            errors.push(httpError);
+        }
+        else if (error?.error?.errors) {
+            // The backend returned an unsuccessful response code.
+            // The response body may contain clues as to what went wrong.
+            errors = ApiError.fromErrors(error.error.errors);
+        }
+        return throwError(() => errors);
+    }
+}
+
+class CreateMixin extends BaseMixin {
+    http;
+    endpoint;
+    cls;
+    constructor(http, endpoint, cls) {
+        super();
+        this.http = http;
+        this.endpoint = endpoint;
+        this.cls = cls;
+    }
+    create(data) {
+        return this.http
+            .post(`${this.endpoint}/`, serialize(this.cls, data))
+            .pipe(map((response) => {
+            return deserialize(this.cls, response.data, response.included);
+        }), catchError(this.handleErrors));
+    }
+}
+
+class DeleteMixin extends BaseMixin {
+    http;
+    endpoint;
+    cls;
+    constructor(http, endpoint, cls) {
+        super();
+        this.http = http;
+        this.endpoint = endpoint;
+        this.cls = cls;
+    }
+    delete(id) {
+        return this.http
+            .delete(`${this.endpoint}/${id}/`)
+            .pipe(catchError(this.handleErrors));
+    }
+}
+
+function createHttpParams(query) {
+    let params = new HttpParams();
+    if (query !== undefined) {
+        Object.keys(query).forEach((key) => {
+            if (key === 'include') {
+                params = params.append(key, query[key]);
+                return;
+            }
+            const values = query[key].split(',');
+            values.forEach((value) => {
+                if (value.trim()) {
+                    params = params.append(key, value);
+                }
+            });
+        });
+    }
+    return params;
+}
+class ListMixin {
+    http;
+    endpoint;
+    cls;
+    constructor(http, endpoint, cls) {
+        this.http = http;
+        this.endpoint = endpoint;
+        this.cls = cls;
+    }
+    list(query, url) {
+        const params = createHttpParams(query);
+        return this.http
+            .get(url ?? `${this.endpoint}/`, { params })
+            .pipe(map((response) => {
+            return deserializeCollection(this.cls, response);
+        }));
+    }
+}
+
+class RetrieveMixin {
+    http;
+    endpoint;
+    cls;
+    constructor(http, endpoint, cls) {
+        this.http = http;
+        this.endpoint = endpoint;
+        this.cls = cls;
+    }
+    retrieve(id, include = []) {
+        let params = new HttpParams();
+        if (include.length !== 0) {
+            params = params.set('include', include.join(','));
+        }
+        return this.http
+            .get(`${this.endpoint}/${id}/`, { params })
+            .pipe(map((response) => {
+            return deserialize(this.cls, response.data, response.included);
+        }));
+    }
+}
+
+class UpdateMixin {
+    http;
+    endpoint;
+    cls;
+    constructor(http, endpoint, cls) {
+        this.http = http;
+        this.endpoint = endpoint;
+        this.cls = cls;
+    }
+    update(id, data) {
+        return this.http
+            .patch(`${this.endpoint}/${id}/`, serialize(this.cls, { id, ...data }))
+            .pipe(map((response) => {
+            return deserialize(this.cls, response.data, []);
+        }));
+    }
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { BaseMixin, CreateMixin, DeleteMixin, ListMixin, RetrieveMixin, UpdateMixin };
+//# sourceMappingURL=vmelou-jsonapi-angular.mjs.map

package/fesm2022/vmelou-jsonapi-angular.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vmelou-jsonapi-angular.mjs","sources":["../../../../../libs/jsonapi/angular/src/lib/mixins/base.mixin.ts","../../../../../libs/jsonapi/angular/src/lib/mixins/create.mixin.ts","../../../../../libs/jsonapi/angular/src/lib/mixins/delete.mixin.ts","../../../../../libs/jsonapi/angular/src/lib/mixins/list.mixin.ts","../../../../../libs/jsonapi/angular/src/lib/mixins/retrieve.mixin.ts","../../../../../libs/jsonapi/angular/src/lib/mixins/update.mixin.ts","../../../../../libs/jsonapi/angular/src/vmelou-jsonapi-angular.ts"],"sourcesContent":["import { HttpErrorResponse } from '@angular/common/http';\nimport { Observable, throwError } from 'rxjs';\nimport { ApiError } from '@vmelou/jsonapi';\n\nexport class BaseMixin {\n  protected handleErrors(\n    error: HttpErrorResponse\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ): Observable<ApiError[] | any> {\n    let errors: ApiError[] = [];\n\n    if (\n      error.error instanceof ProgressEvent ||\n      error.error instanceof ErrorEvent ||\n      error.error instanceof TypeError\n    ) {\n      // A client-side or network error occurred. Handle it accordingly.\n      const httpError = new ApiError('', error.message, '0');\n      errors.push(httpError);\n    } else if (error?.error?.errors) {\n      // The backend returned an unsuccessful response code.\n      // The response body may contain clues as to what went wrong.\n      errors = ApiError.fromErrors(error.error.errors);\n    }\n\n    return throwError(() => errors);\n  }\n}\n","import { HttpClient } from '@angular/common/http';\nimport { Observable, catchError, map } from 'rxjs';\nimport {\n  BaseResource,\n  deserialize,\n  JsonDetailResponse,\n  serialize,\n} from '@vmelou/jsonapi';\n\nimport { BaseMixin } from './base.mixin';\n\nexport class CreateMixin<T extends BaseResource> extends BaseMixin {\n  constructor(\n    private http: HttpClient,\n    private endpoint: string,\n    protected readonly cls: new () => T\n  ) {\n    super();\n  }\n\n  create(data: Partial<T>): Observable<T> {\n    return this.http\n      .post<JsonDetailResponse>(`${this.endpoint}/`, serialize(this.cls, data))\n      .pipe(\n        map((response: JsonDetailResponse) => {\n          return deserialize<T>(this.cls, response.data, response.included);\n        }),\n        catchError(this.handleErrors)\n      );\n  }\n}\n","import { HttpClient } from '@angular/common/http';\nimport { Observable, catchError } from 'rxjs';\nimport { BaseResource } from '@vmelou/jsonapi';\n\nimport { BaseMixin } from './base.mixin';\n\nexport class DeleteMixin<T extends BaseResource> extends BaseMixin {\n  constructor(\n    private http: HttpClient,\n    private endpoint: string,\n    protected readonly cls: new () => T\n  ) {\n    super();\n  }\n\n  delete(id: string): Observable<void> {\n    return this.http\n      .delete<void>(`${this.endpoint}/${id}/`)\n      .pipe(catchError(this.handleErrors));\n  }\n}\n","import { HttpClient, HttpParams } from '@angular/common/http';\nimport { Observable, map } from 'rxjs';\n\nimport {\n  BaseResource,\n  deserializeCollection,\n  JsonListResponse,\n  Results,\n} from '@vmelou/jsonapi';\n\nfunction createHttpParams(query?: { [key: string]: string }): HttpParams {\n  let params = new HttpParams();\n  if (query !== undefined) {\n    Object.keys(query).forEach((key: string) => {\n      if (key === 'include') {\n        params = params.append(key, query[key]);\n        return;\n      }\n\n      const values = query[key].split(',');\n      values.forEach((value: string) => {\n        if (value.trim()) {\n          params = params.append(key, value);\n        }\n      });\n    });\n  }\n  return params;\n}\n\nexport class ListMixin<T extends BaseResource> {\n  constructor(\n    private http: HttpClient,\n    private endpoint: string,\n    protected readonly cls: new () => T\n  ) {}\n\n  list(\n    query?: { [key: string]: string },\n    url?: string\n  ): Observable<Results<T>> {\n    const params = createHttpParams(query);\n\n    return this.http\n      .get<JsonListResponse>(url ?? `${this.endpoint}/`, { params })\n      .pipe(\n        map((response: JsonListResponse) => {\n          return deserializeCollection(this.cls, response);\n        })\n      );\n  }\n}\n","import { HttpClient, HttpParams } from '@angular/common/http';\nimport { Observable, map } from 'rxjs';\nimport { BaseResource, deserialize, JsonDetailResponse } from '@vmelou/jsonapi';\n\nexport class RetrieveMixin<T extends BaseResource> {\n  constructor(\n    private http: HttpClient,\n    private endpoint: string,\n    protected readonly cls: new () => T\n  ) {}\n\n  retrieve(id: string, include: string[] = []): Observable<T> {\n    let params = new HttpParams();\n\n    if (include.length !== 0) {\n      params = params.set('include', include.join(','));\n    }\n\n    return this.http\n      .get<JsonDetailResponse>(`${this.endpoint}/${id}/`, { params })\n      .pipe(\n        map((response: JsonDetailResponse) => {\n          return deserialize<T>(this.cls, response.data, response.included);\n        })\n      );\n  }\n}\n","import { HttpClient } from '@angular/common/http';\nimport { Observable, map } from 'rxjs';\nimport {\n  JsonDetailResponse,\n  BaseResource,\n  deserialize,\n  serialize,\n} from '@vmelou/jsonapi';\n\nexport class UpdateMixin<T extends BaseResource> {\n  constructor(\n    private http: HttpClient,\n    private endpoint: string,\n    protected readonly cls: new () => T\n  ) {}\n\n  update(id: string, data: Partial<T>): Observable<T> {\n    return this.http\n      .patch<JsonDetailResponse>(\n        `${this.endpoint}/${id}/`,\n        serialize(this.cls, { id, ...data })\n      )\n      .pipe(\n        map((response: JsonDetailResponse) => {\n          return deserialize(this.cls, response.data, []);\n        })\n      );\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,6 @@
+export * from './lib/mixins/base.mixin';
+export * from './lib/mixins/create.mixin';
+export * from './lib/mixins/delete.mixin';
+export * from './lib/mixins/list.mixin';
+export * from './lib/mixins/retrieve.mixin';
+export * from './lib/mixins/update.mixin';

package/lib/mixins/base.mixin.d.ts

@@ -0,0 +1,6 @@
+import { HttpErrorResponse } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import { ApiError } from '@vmelou/jsonapi';
+export declare class BaseMixin {
+    protected handleErrors(error: HttpErrorResponse): Observable<ApiError[] | any>;
+}

package/lib/mixins/create.mixin.d.ts

@@ -0,0 +1,11 @@
+import { HttpClient } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import { BaseResource } from '@vmelou/jsonapi';
+import { BaseMixin } from './base.mixin';
+export declare class CreateMixin<T extends BaseResource> extends BaseMixin {
+    private http;
+    private endpoint;
+    protected readonly cls: new () => T;
+    constructor(http: HttpClient, endpoint: string, cls: new () => T);
+    create(data: Partial<T>): Observable<T>;
+}

package/lib/mixins/delete.mixin.d.ts

@@ -0,0 +1,11 @@
+import { HttpClient } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import { BaseResource } from '@vmelou/jsonapi';
+import { BaseMixin } from './base.mixin';
+export declare class DeleteMixin<T extends BaseResource> extends BaseMixin {
+    private http;
+    private endpoint;
+    protected readonly cls: new () => T;
+    constructor(http: HttpClient, endpoint: string, cls: new () => T);
+    delete(id: string): Observable<void>;
+}

package/lib/mixins/list.mixin.d.ts

@@ -0,0 +1,12 @@
+import { HttpClient } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import { BaseResource, Results } from '@vmelou/jsonapi';
+export declare class ListMixin<T extends BaseResource> {
+    private http;
+    private endpoint;
+    protected readonly cls: new () => T;
+    constructor(http: HttpClient, endpoint: string, cls: new () => T);
+    list(query?: {
+        [key: string]: string;
+    }, url?: string): Observable<Results<T>>;
+}

package/lib/mixins/retrieve.mixin.d.ts

@@ -0,0 +1,10 @@
+import { HttpClient } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import { BaseResource } from '@vmelou/jsonapi';
+export declare class RetrieveMixin<T extends BaseResource> {
+    private http;
+    private endpoint;
+    protected readonly cls: new () => T;
+    constructor(http: HttpClient, endpoint: string, cls: new () => T);
+    retrieve(id: string, include?: string[]): Observable<T>;
+}

package/lib/mixins/update.mixin.d.ts

@@ -0,0 +1,10 @@
+import { HttpClient } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import { BaseResource } from '@vmelou/jsonapi';
+export declare class UpdateMixin<T extends BaseResource> {
+    private http;
+    private endpoint;
+    protected readonly cls: new () => T;
+    constructor(http: HttpClient, endpoint: string, cls: new () => T);
+    update(id: string, data: Partial<T>): Observable<T>;
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@vmelou/jsonapi-angular",
+  "version": "0.4.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@angular/common": "^19.2.0",
+    "@vmelou/jsonapi": "^0.4.0",
+    "rxjs": "^7.8.0"
+  },
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/valerymelou/json-api.git"
+  },
+  "license": "MIT",
+  "module": "fesm2022/vmelou-jsonapi-angular.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./fesm2022/vmelou-jsonapi-angular.mjs"
+    }
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}