ngx-grs v0.1.5

ngx-grs

Installation

npm install ngx-grs

or

pnpm add ngx-grs

or 

yarn add ngx-grs

or 

bun add ngx-grs

Usage

1. Create an Angular service and extend it with the NgxGenericRestService class:

   @Injectable({ providedIn: "root" })
   export class PlanetsService extends NgxGenericRestService {}

2. Call the constructor of the NgxGenericRestService class and provide the baseUrl and resourceName:

   @Injectable({ providedIn: "root" })
   export class PlanetsService extends NgxGenericRestService {
      constructor() {
        super({
          baseUrl: "https://dragonball-api.com/api"
          resourceName: "planets",
        });       
      }
   }

3. Use the service somewhere in your code:

   type ApiResponse<T> =
   | {
       items: T[];
       links: {
         first: string;
         last: string;
         next: string;
         previous: string;
       };
       meta: {
         currentPage: number;
         itemCount: number;
         itemsPerPage: number;
         totalItems: number;
         totalPages: number;
       };
     }
   | undefined;
   
   type Planet = {
     id: number;
     name: string;
     isDestroyed: boolean;
     description: string;
     image: string;
     deletedAt: Date | null;
   };
   
   type PlanetCreate = Pick<Planet, 'name' | 'isDestroyed' | 'description' | 'image'>;
   
   type PlanetUpdate = Partial<PlanetCreate>;
   
   @Component({
     selector: 'app-root',
     standalone: true,
     templateUrl: './app.component.html',
   })
   export class SomeComponent implements OnInit {
     #planetsService = inject(PlanetsService);
   
     planets = signal<ApiResponse<Planet>>(undefined);
   
     ngOnInit(): void {
       this.#planetsService.list<ApiResponse<Planet>>().subscribe(this.planets.set);
     }
   
     create(planet: PlanetCreate): void {
       this.#planetsService.add<PlanetCreate, Planet>().subscribe();
     }
   
     update(id: number, planet: PlanetUpdate): void {      
       this.#planetsService.update<PlanetUpdate, Planet>(id, planet).subscribe();
     }
   
     delete(id: number): void {
       this.#planetsService.delete<Planet>(id).subscribe();
     }
   }

Default HttpClient request options

Custom HTTP options