ng2-rest 19.0.29 → 19.0.31

package/README.md

@@ -1,135 +1,135 @@
-
-## ng2-rest ##
-
-Robust isomorphic REST framework for browser (Angular, React etc.) and backend (NodeJS) JavaScript/TypeScript apps.
-
-Features:
-- Compatible with Angular (2+) (newest 13,14 also...) , React, Vue , NodeJS (works everywhere)
-- Compatible with RxJS operators (exhaustMap, switchMap, request cancelation etc.)
-- Based on [axios](https://axios-http.com/) => excellent alternative to  Angular's [HttpClient](https://angular.io/api/common/http/HttpClient)
-- JSONP api request handling
-- Transfer class instance from server to client and back
-- Elegant way of dealing with REST api ( *similar to ExpressJS routes definitions* )
-
-(more documentation soon... )
-
-To install this package run:
-
-    npm install ng2-rest --save
-
-Import Resource class:
-```ts
-import { Resource } from 'ng2-rest/browser';
-```
-
-Resource
-========
-
-Fit you existing API (not only REST) into new fluent objects with **Resource** 
- class observables. Use power of **async** in new angular templates;
-
-**template.html**  
-```html
-Users:
-<ul   *ngIf="model.allUsers() | async; else loader; let users" >
-
-  <li  *ngFor="let user of users"> 
-  		{{user.id}} {{user.fullName()}} 
-		  <br>
-		<input type="name" [(NgModel)]="user.name" >
-		<button (click)="model.update(user)" > Update </button>
-  </li>
-
-</ul>
-
-<ng-template #loader> loading users...  </ng-template>
-
-```
-**component.ts**
-```ts
-class User {
-	name: string;
-	surname: string;
-	id: number;
-
-	fullName() {
-		return `Surname: ${this.surname}, Name: ${this.name}`;
-	}
-}
-
-// Express.js style url endpoint model
-// you can ommit "<User>" part is you don't wanna see response interface
-// also you can ommit third argument ",User" is you don't wanna
-// map response object to User class objects
-const rest = Resource.create<User>("http://yourbackend.com/api","users/:id",{'':User} )
-
-class UserComponent {
-
-   // Prepare your beautiful interface
-    model = {
-	 allUsers: () => rest.model()
-		 .array
-		 .get()
-		 .observable // Observable resposne (useful for Angular 2+ html templates)
-     .pipe( map({ body } => body.json) ) // get all users, body.json => User[] 
-
-	 userBy: (id) => rest.model({id})
-		 .get() // Promise response by default
-		 .then({ body } => console.log(body.json)) // get user by id,  body.json => User
-
-	 update: async (user:User) =>{
-		 try {
-			await rest.model({id:user.id}).put(user) // Promise response by default
-
-			alert('Update sucess')
-		 } catch(e) {
-			alert(e)
-		 }	
-	 	}
-    }
-
-	constructor() { }
-
-}
-```
-
-Specification
-============
-Example **UrlParams[]** :
- `[ { sort: true },{ filter: 'id,5' }, { filter: 'name,test' } ]` 
- 
- 
-| Name | Parameters  | Description |
-| :---: | --- | ---: |
-| **.array.** | get,post,put,head,delete,jsonp |  for everything, but with arrays |
-| **get** | `UrlParams[] ` |   get model by parameters  |
-| **post** | `model, UrlParams[] ` |   post object model  |
-| **put** | `model, UrlParams[]` |   put object model |
-| **head** | `model, UrlParams[]` |   get head for model  |
-| **delete** | `UrlParams[]` |   remove object by params |
-| **jsonp** | `UrlParams[]` |   get jsonp data |
-
-
-
-# Production mode
-===
-Nice things to do in production mode:
-
-**1. Disable warnings.**
-
-If you don't wanna see warning, disable it like this:
-```ts
-if (environment.production) {
-  Resource.enableWarnings = false;
-}
-```
-
-# Angular 2+ ngZone
-If you are using Angular 2+ you need to do this in your root **app.component**:
-```ts
-constructor(zone:NgZone) {
-    Resource.initAngularNgZone(zone)
-}
-```
-
-
+
+## ng2-rest ##
+
+Robust isomorphic REST framework for browser (Angular, React etc.) and backend (NodeJS) JavaScript/TypeScript apps.
+
+Features:
+- Compatible with Angular (2+) (newest 13,14 also...) , React, Vue , NodeJS (works everywhere)
+- Compatible with RxJS operators (exhaustMap, switchMap, request cancelation etc.)
+- Based on [axios](https://axios-http.com/) => excellent alternative to  Angular's [HttpClient](https://angular.io/api/common/http/HttpClient)
+- JSONP api request handling
+- Transfer class instance from server to client and back
+- Elegant way of dealing with REST api ( *similar to ExpressJS routes definitions* )
+
+(more documentation soon... )
+
+To install this package run:
+
+    npm install ng2-rest --save
+
+Import Resource class:
+```ts
+import { Resource } from 'ng2-rest/browser';
+```
+
+Resource
+========
+
+Fit you existing API (not only REST) into new fluent objects with **Resource** 
+ class observables. Use power of **async** in new angular templates;
+
+**template.html**  
+```html
+Users:
+<ul   *ngIf="model.allUsers() | async; else loader; let users" >
+
+  <li  *ngFor="let user of users"> 
+  		{{user.id}} {{user.fullName()}} 
+		  <br>
+		<input type="name" [(NgModel)]="user.name" >
+		<button (click)="model.update(user)" > Update </button>
+  </li>
+
+</ul>
+
+<ng-template #loader> loading users...  </ng-template>
+
+```
+**component.ts**
+```ts
+class User {
+	name: string;
+	surname: string;
+	id: number;
+
+	fullName() {
+		return `Surname: ${this.surname}, Name: ${this.name}`;
+	}
+}
+
+// Express.js style url endpoint model
+// you can ommit "<User>" part is you don't wanna see response interface
+// also you can ommit third argument ",User" is you don't wanna
+// map response object to User class objects
+const rest = Resource.create<User>("http://yourbackend.com/api","users/:id",{'':User} )
+
+class UserComponent {
+
+   // Prepare your beautiful interface
+    model = {
+	 allUsers: () => rest.model()
+		 .array
+		 .get()
+		 .observable // Observable resposne (useful for Angular 2+ html templates)
+     .pipe( map({ body } => body.json) ) // get all users, body.json => User[] 
+
+	 userBy: (id) => rest.model({id})
+		 .get() // Promise response by default
+		 .then({ body } => console.log(body.json)) // get user by id,  body.json => User
+
+	 update: async (user:User) =>{
+		 try {
+			await rest.model({id:user.id}).put(user) // Promise response by default
+
+			alert('Update sucess')
+		 } catch(e) {
+			alert(e)
+		 }	
+	 	}
+    }
+
+	constructor() { }
+
+}
+```
+
+Specification
+============
+Example **UrlParams[]** :
+ `[ { sort: true },{ filter: 'id,5' }, { filter: 'name,test' } ]` 
+ 
+ 
+| Name | Parameters  | Description |
+| :---: | --- | ---: |
+| **.array.** | get,post,put,head,delete,jsonp |  for everything, but with arrays |
+| **get** | `UrlParams[] ` |   get model by parameters  |
+| **post** | `model, UrlParams[] ` |   post object model  |
+| **put** | `model, UrlParams[]` |   put object model |
+| **head** | `model, UrlParams[]` |   get head for model  |
+| **delete** | `UrlParams[]` |   remove object by params |
+| **jsonp** | `UrlParams[]` |   get jsonp data |
+
+
+
+# Production mode
+===
+Nice things to do in production mode:
+
+**1. Disable warnings.**
+
+If you don't wanna see warning, disable it like this:
+```ts
+if (environment.production) {
+  Resource.enableWarnings = false;
+}
+```
+
+# Angular 2+ ngZone
+If you are using Angular 2+ you need to do this in your root **app.component**:
+```ts
+constructor(zone:NgZone) {
+    Resource.initAngularNgZone(zone)
+}
+```
+
+

package/browser/README.md

@@ -1,24 +1,24 @@
-# MyLib
-
-This library was generated with [Angular CLI](https://github.com/angular/angular-cli) version 13.2.0.
-
-## Code scaffolding
-
-Run `ng generate component component-name --project my-lib` to generate a new component. You can also use `ng generate directive|pipe|service|class|guard|interface|enum|module --project my-lib`.
-> Note: Don't forget to add `--project my-lib` or else it will be added to the default project in your `angular.json` file. 
-
-## Build
-
-Run `ng build my-lib` to build the project. The build artifacts will be stored in the `dist/` directory.
-
-## Publishing
-
-After building your library with `ng build my-lib`, go to the dist folder `cd dist/my-lib` and run `npm publish`.
-
-## Running unit tests
-
-Run `ng test my-lib` to execute the unit tests via [Karma](https://karma-runner.github.io).
-
-## Further help
-
-To get more help on the Angular CLI use `ng help` or go check out the [Angular CLI Overview and Command Reference](https://angular.io/cli) page.
+# MyLib
+
+This library was generated with [Angular CLI](https://github.com/angular/angular-cli) version 13.2.0.
+
+## Code scaffolding
+
+Run `ng generate component component-name --project my-lib` to generate a new component. You can also use `ng generate directive|pipe|service|class|guard|interface|enum|module --project my-lib`.
+> Note: Don't forget to add `--project my-lib` or else it will be added to the default project in your `angular.json` file. 
+
+## Build
+
+Run `ng build my-lib` to build the project. The build artifacts will be stored in the `dist/` directory.
+
+## Publishing
+
+After building your library with `ng build my-lib`, go to the dist folder `cd dist/my-lib` and run `npm publish`.
+
+## Running unit tests
+
+Run `ng test my-lib` to execute the unit tests via [Karma](https://karma-runner.github.io).
+
+## Further help
+
+To get more help on the Angular CLI use `ng help` or go check out the [Angular CLI Overview and Command Reference](https://angular.io/cli) page.