*BREAKING CHANGE* feature(http): request path interceptors (#202)

* create an interface for url comparation and a RegEx implementation of it (IURLCompare)

* created a separate file for IHttpInterceptor and moved into /interceptors

* move unit test into /interceptors

* added interceptor mappings as a new feature and restructured code

* fixed http module to configure new mappings correctly

* fixed index.ts to export correct interfaces

* renamed compare interfaces with matcher and made it more flexible for any type of interceptions

* pass instance of matcher interface on constructor

* remove HttpInterceptorService from provider since its not needed

* validate for empty strings when matching in url-regexp matche

* added unit tests for ** and /path** interceptors

* updated unit tests with more interceptor cases

* added unit tests for url regexp interceptor matcher

* added some docblocks

* added examples for path interception

* fixed docs to use `paths` and as an array

* chages for AoT future support in http.module

* updated http-interceptor.service unit tests with AoT changes

* added Type<IHttpInterceptor> type for interceptor providers in docs and unit tests

* updated docs with AoT changes

src/app/components/components/http/http.component.html

@@ -70,17 +70,31 @@ <h3>Setup:</h3>
         }
       ]]>
     </td-highlight>
-    <p>Then, import the [CovalentHttpModule] using the <code>forRoot()</code> method with the desired interceptors in your NgModule:</p>
+    <p>Then, import the [CovalentHttpModule] using the <code>forRoot()</code> method with the desired interceptors and paths to intercept in your NgModule:</p>
     <td-highlight lang="typescript">
       <![CDATA[
+        import { NgModule, Type } from '@angular/core';
         import { HttpModule } from '@angular/http';
-        import { CovalentHttpModule } from '@covalent/http';
+        import { CovalentHttpModule, IHttpInterceptor } from '@covalent/http';
         import { CustomInterceptor } from 'dir/to/interceptor';
 
+        const httpInterceptorProviders: Type<IHttpInterceptor>[] = [
+          CustomInterceptor,
+          ...
+        ];
+
         @NgModule({
           imports: [
             HttpModule, /* or CovalentCoreModule.forRoot() */
-            CovalentHttpModule.forRoot([CustomInterceptor]),
+            CovalentHttpModule.forRoot({
+              interceptors: [{
+                interceptor: CustomInterceptor, paths: ['**'],
+              }],
+            }),
+            ...
+          ],
+          providers: [
+            httpInterceptorProviders,
             ...
           ],
           ...
@@ -89,6 +103,63 @@ <h3>Setup:</h3>
       ]]>
     </td-highlight>
     <p>After that, just inject [HttpInterceptorService] and use it for your requests.</p>
+    <h3>Paths:</h3>
+    <p>The following characters are accepted as a path to intercept:</p>
+    <td-markdown>
+      <pre><code>
+- `**` is a wildcard for `[a-zA-Z0-9-_]` (including `/`)
+- `*` is a wildcard for `[a-zA-Z0-9-_]` (excluding `/`)
+- `[a-zA-Z0-9-_]`
+      </code></pre>
+    </td-markdown>
+    <h3>Examples:</h3>
+    <td-markdown>
+      <pre><code>
+Example 1
+
+`/users/*/groups` intercepts:
+- `www.url.com/users/id-of-user/groups`
+- `www.url.com/users/id/groups`
+
+`/users/*/groups` DOES NOT intercept:
+- `www.url.com/users/id-of-user/groups/path`
+- `www.url.com/users/id-of-user/path/groups`
+- `www.url.com/users/groups`
+
+Example 2
+
+`/users/**/groups` intercepts:
+- `www.url.com/users/id-of-user/groups`
+- `www.url.com/users/id/groups`
+- `www.url.com/users/id-of-user/path/groups`
+
+`/users/**/groups` DOES NOT intercept:
+- `www.url.com/users/id-of-user/groups/path`
+- `www.url.com/users/groups`
+
+Example 3
+
+`/users/**` intercepts:
+- `www.url.com/users/id-of-user/groups`
+- `www.url.com/users/id/groups`
+- `www.url.com/users/id-of-user/path/groups`
+- `www.url.com/users/id-of-user/groups/path`
+- `www.url.com/users/groups`
+
+`/users/**` DOES NOT intercept:
+- `www.url.com/users`
+
+Example 4
+
+`/users**` intercepts:
+- `www.url.com/users/id-of-user/groups`
+- `www.url.com/users/id/groups`
+- `www.url.com/users/id-of-user/path/groups`
+- `www.url.com/users/id-of-user/groups/path`
+- `www.url.com/users/groups`
+- `www.url.com/users`
+      </code></pre>
+    </td-markdown>
   </md-card-content>
 </md-card>
 <md-card>

src/platform/http/README.md

@@ -73,16 +73,31 @@ export class CustomInterceptor implements IHttpInterceptor {
 
 ```
 
-Then, import the [CovalentHttpModule] using the forRoot() method with the desired interceptors in your NgModule:
+Then, import the [CovalentHttpModule] using the forRoot() method with the desired interceptors and paths to intercept in your NgModule:
 
 ```typescript
+import { NgModule, Type } from '@angular/core';
 import { HttpModule } from '@angular/http';
-import { CovalentHttpModule } from '@covalent/http';
+import { CovalentHttpModule, IHttpInterceptor } from '@covalent/http';
 import { CustomInterceptor } from 'dir/to/interceptor';
+
+const httpInterceptorProviders: Type<IHttpInterceptor>[] = [
+  CustomInterceptor,
+  ...
+];
+
 @NgModule({
   imports: [
     HttpModule, /* or CovalentCoreModule.forRoot() */
-    CovalentHttpModule.forRoot([CustomInterceptor]),
+    CovalentHttpModule.forRoot({
+      interceptors: [{
+        interceptor: CustomInterceptor, paths: ['**'],
+      }],
+    }),
+    ...
+  ],
+  providers: [
+    httpInterceptorProviders,
     ...
   ],
   ...
@@ -92,6 +107,59 @@ export class MyModule {}
 
 After that, just inject [HttpInterceptorService] and use it for your requests.
 
+## Paths
+
+The following characters are accepted as a path to intercept
+- `**` is a wildcard for `[a-zA-Z0-9-_]` (including `/`)
+- `*` is a wildcard for `[a-zA-Z0-9-_]` (excluding `/`)
+- `[a-zA-Z0-9-_]`
+
+#### Examples
+
+Example 1
+
+`/users/*/groups` intercepts:
+- `www.url.com/users/id-of-user/groups`
+- `www.url.com/users/id/groups`
+
+`/users/*/groups` DOES NOT intercept:
+- `www.url.com/users/id-of-user/groups/path`
+- `www.url.com/users/id-of-user/path/groups`
+- `www.url.com/users/groups`
+
+Example 2
+
+`/users/**/groups` intercepts:
+- `www.url.com/users/id-of-user/groups`
+- `www.url.com/users/id/groups`
+- `www.url.com/users/id-of-user/path/groups`
+
+`/users/**/groups` DOES NOT intercept:
+- `www.url.com/users/id-of-user/groups/path`
+- `www.url.com/users/groups`
+
+Example 3
+
+`/users/**` intercepts:
+- `www.url.com/users/id-of-user/groups`
+- `www.url.com/users/id/groups`
+- `www.url.com/users/id-of-user/path/groups`
+- `www.url.com/users/id-of-user/groups/path`
+- `www.url.com/users/groups`
+
+`/users/**` DOES NOT intercept:
+- `www.url.com/users`
+
+Example 4
+
+`/users**` intercepts:
+- `www.url.com/users/id-of-user/groups`
+- `www.url.com/users/id/groups`
+- `www.url.com/users/id-of-user/path/groups`
+- `www.url.com/users/id-of-user/groups/path`
+- `www.url.com/users/groups`
+- `www.url.com/users`
+
 
 # RESTService