@tinkoff/router 0.1.63 → 0.1.67

package/README.md

@@ -66,8 +66,25 @@ export const myGuard: NavigationGuard = async ({ to }) => {
 
   // if nothing is returned, the transition will be performed as usual
 };
+
+router.registerGuard(myGuard);
 ```
 
+#### Rules
+
+- guards are asynchronous and it execution will be awaited inside routing
+- all guards are running in parallel and they are all awaited
+- if several guars return something then the result from a guard that was registered early will be used
+
+#### Possible result
+
+The behaviour of routing depends on the result of executing guards functions and there result might be next:
+
+- if all of the guards returns `undefined` than navigation will continue executing
+- if any of the guards returns `false` than navigation is getting blocked and next action differs on server and client
+- if any of the guards returns `string` it is considered as url to which redirect should be happen
+- if any of the guards returns `NavigateOptions` interface, `url` property from it is considered as url to which redirect should be happen
+
 ### Transitions hooks
 
 Transition hooks allow you to perform your asynchronous actions at different stages of the transition.
@@ -78,8 +95,27 @@ import { NavigationHook } from '@tinkoff/router';
 export const myHook: NavigationHook = async ({ from, to, url, fromUrl }) => {
   console.log(`navigating from ${from} to route ${to}`);
 };
+
+router.registerHook('beforeNavigate', myHook);
 ```
 
+#### Rules
+
+- all hooks from the same event are running in parallel
+- most of the hooks are asynchronous and are awaited inside router
+- if some error happens when running hook it will be logged to console but wont affect navigation (except for the `beforeResolve` hook - error for it will be rethrown)
+
+#### List of available hooks
+
+Async hooks:
+
+- [navigate hooks](#navigate-hooks) - asynchronous hooks only for navigate calls
+- [updateCurrentRoute hooks](#updatecurrentroute-hooks) - asynchronous hooks only for updateCurrentRoute calls
+
+Sync hooks:
+
+- `change` - runs when any of changes to current route\url happens
+
 ## API
 
 ### Getting data about the current route or url
@@ -102,12 +138,20 @@ router.navigate('/test');
 router.navigate({ url: './test', query: { a: '1' } });
 ```
 
-Transition hooks:
+##### navigate hooks
 
 - beforeResolve
 - beforeNavigate
 - afterNavigate
 
+##### navigate workflow
+
+1. `beforeResolve` hook
+2. [guards](#router-guards)
+3. `beforeNavigate`
+4. `change`
+5. `afterNavigate`
+
 #### updateCurrentRoute
 
 The transition is based on the current route (therefore this method cannot be called on the server) and allows you to simply update some data for the current page
@@ -117,11 +161,17 @@ router.updateCurrentRoute({ params: { id: 'abc' } });
 router.updateCurrentRoute({ query: { a: '1' } });
 ```
 
-Hooks:
+##### updateCurrentRoute hooks
 
 - beforeUpdateCurrent
 - afterUpdateCurrent
 
+##### updateCurrentRoute workflow
+
+1. `beforeUpdateCurrent`
+2. `change`
+3. `afterUpdateCurrent`
+
 ### Working with query
 
 #### query option
@@ -161,6 +211,11 @@ router.updateCurrentRoute({ query: { a: undefined, c: 'c' }, preserveQuery: true
 router.getCurrentUrl().query; // { b: 'b', c: 'c' }
 ```
 
+### Constructor options
+
+- `trailingSlash` - do router should force all urls to end with slash. If `true` - force trailing slash for every path, `false` - force no trailing slash, `undefined` - trailing slash is specified by request and both trailing and not trailing slashes are used. By default value if `undefined`
+- `mergeSlashes` - replace several consecutive slashes by single slashes (slashes after protocol are still be with `//` after protocol name). By default is `false` - no merge for slashes.
+
 ### Integration with React
 
 Library has some useful React hooks and components for working with routing
@@ -229,3 +284,26 @@ export const WrapLink = () => {
   return <Link url="/test/">Click me</Link>;
 };
 ```
+
+## How to
+
+### Load route config from external api
+
+Use [transition hook](#transitions-hooks) `beforeResolve` and load routes config based on url.
+
+```ts
+router.registerHook('beforeResolve', async (navigation) => {
+  const route = await routeResolve(navigation);
+
+  if (route) {
+    router.addRoute(routeTransform(route));
+  }
+});
+```
+
+### App behind proxy
+
+Router doesn't support proxy setup directly. But proxy still can be used with some limitations:
+
+- setup proxy server to pass requests to app with rewriting request and response paths. (E.g. for [nginx](http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_redirect))
+- it wont work as expected on spa navigation on client, so only option in this case is use the `NoSpaRouter`

package/lib/index.es.js

@@ -668,9 +668,11 @@ class RouteTree {
 
 class Router extends AbstractRouter {
     constructor(options) {
+        var _a;
         super(options);
         this.blocked = false;
         this.tree = new RouteTree(options.routes);
+        this.defaultRedirectCode = (_a = options.defaultRedirectCode) !== null && _a !== void 0 ? _a : 308;
         this.history = new ServerHistory();
     }
     async dehydrate() {
@@ -713,13 +715,13 @@ class Router extends AbstractRouter {
     normalizePathname(pathname) {
         const normalized = super.normalizePathname(pathname);
         if (normalized !== pathname) {
-            this.redirectCode = 308;
+            this.redirectCode = this.defaultRedirectCode;
         }
         return normalized;
     }
     resolveUrl(options) {
         if (options.url && isInvalidUrl(options.url)) {
-            this.redirectCode = 308;
+            this.redirectCode = this.defaultRedirectCode;
         }
         return super.resolveUrl(options);
     }

package/lib/index.js

@@ -684,9 +684,11 @@ class RouteTree {
 
 class Router extends AbstractRouter {
     constructor(options) {
+        var _a;
         super(options);
         this.blocked = false;
         this.tree = new RouteTree(options.routes);
+        this.defaultRedirectCode = (_a = options.defaultRedirectCode) !== null && _a !== void 0 ? _a : 308;
         this.history = new ServerHistory();
     }
     async dehydrate() {
@@ -729,13 +731,13 @@ class Router extends AbstractRouter {
     normalizePathname(pathname) {
         const normalized = super.normalizePathname(pathname);
         if (normalized !== pathname) {
-            this.redirectCode = 308;
+            this.redirectCode = this.defaultRedirectCode;
         }
         return normalized;
     }
     resolveUrl(options) {
         if (options.url && url.isInvalidUrl(options.url)) {
-            this.redirectCode = 308;
+            this.redirectCode = this.defaultRedirectCode;
         }
         return super.resolveUrl(options);
     }

package/lib/router/abstract.d.ts

@@ -16,6 +16,7 @@ export interface Options {
     afterUpdateCurrent?: NavigationHook[];
     guards?: NavigationGuard[];
     onChange?: NavigationSyncHook[];
+    defaultRedirectCode?: number;
 }
 interface InternalOptions {
     history?: boolean;

package/lib/router/server.d.ts

@@ -1,14 +1,11 @@
 import type { Options } from './abstract';
 import { AbstractRouter } from './abstract';
-import type { Navigation, NavigateOptions, HookName, NavigationHook } from '../types';
+import type { Navigation, NavigateOptions, HookName } from '../types';
 export declare class Router extends AbstractRouter {
+    protected defaultRedirectCode: number;
     protected blocked: boolean;
     protected redirectCode?: number;
-    constructor(options: Options & {
-        onRedirect: (navigation: Navigation) => Promise<void>;
-        onNotFound: NavigationHook;
-        onBlock: NavigationHook;
-    });
+    constructor(options: Options);
     protected onRedirect: (navigation: Navigation) => Promise<void>;
     dehydrate(): Promise<Navigation>;
     protected run(navigation: Navigation): Promise<void>;

package/lib/types.d.ts

@@ -1,5 +1,5 @@
 import type { Url, Query } from '@tinkoff/url';
-export declare type Params = Record<string, string | null>;
+export declare type Params = Record<string, string>;
 export interface Route {
     name: string;
     path: string;
@@ -13,8 +13,8 @@ export interface NavigationRoute extends Route {
     navigateState?: any;
 }
 export interface BaseNavigateOptions {
-    params?: Params;
-    query?: Query;
+    params?: Partial<Params>;
+    query?: Partial<Query>;
     preserveQuery?: boolean;
     replace?: boolean;
     hash?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinkoff/router",
-  "version": "0.1.63",
+  "version": "0.1.67",
   "description": "router",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -14,7 +14,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git@github.com:TinkoffCreditSystems/tramvai.git"
+    "url": "git@github.com:Tinkoff/tramvai.git"
   },
   "scripts": {
     "build": "tramvai-build --for-publish",