@nx/angular 16.0.0-beta.1

package/src/migrations/update-15-9-0/update-file-server-executor.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const versions_1 = require("../../utils/versions");
+function updateFileServerExecutor(tree) {
+    var _a;
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const oldExecutor = '@nrwl/angular:file-server';
+        const newExecutor = '@nrwl/web:file-server';
+        let needsNrwlWeb = false;
+        const nxJson = (0, devkit_1.readNxJson)(tree);
+        if (nxJson.targetDefaults) {
+            let nxJsonChanged = false;
+            for (const [targetName, target] of Object.entries(nxJson.targetDefaults)) {
+                if (target.executor === oldExecutor) {
+                    nxJson.targetDefaults[targetName].executor = newExecutor;
+                    nxJsonChanged = true;
+                    needsNrwlWeb = true;
+                }
+            }
+            if (nxJsonChanged) {
+                (0, devkit_1.updateNxJson)(tree, nxJson);
+            }
+        }
+        const projects = (0, devkit_1.getProjects)(tree);
+        for (const [projectName, project] of projects.entries()) {
+            let projectChanged = false;
+            for (const [targetName, target] of Object.entries((_a = project.targets) !== null && _a !== void 0 ? _a : {})) {
+                if (target.executor === oldExecutor) {
+                    project.targets[targetName].executor = newExecutor;
+                    projectChanged = true;
+                    needsNrwlWeb = true;
+                }
+            }
+            if (projectChanged) {
+                (0, devkit_1.updateProjectConfiguration)(tree, projectName, project);
+            }
+        }
+        if (needsNrwlWeb) {
+            (0, devkit_1.addDependenciesToPackageJson)(tree, {}, { '@nrwl/web': versions_1.nxVersion });
+        }
+        yield (0, devkit_1.formatFiles)(tree);
+    });
+}
+exports.default = updateFileServerExecutor;
+//# sourceMappingURL=update-file-server-executor.js.map

package/src/migrations/update-15-9-0/update-file-server-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-file-server-executor.js","sourceRoot":"","sources":["../../../../../../packages/angular/src/migrations/update-15-9-0/update-file-server-executor.ts"],"names":[],"mappings":";;;AACA,uCAOoB;AACpB,mDAAiD;AAEjD,SAA8B,wBAAwB,CAAC,IAAU;;;QAC/D,MAAM,WAAW,GAAG,2BAA2B,CAAC;QAChD,MAAM,WAAW,GAAG,uBAAuB,CAAC;QAC5C,IAAI,YAAY,GAAG,KAAK,CAAC;QAEzB,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,IAAI,CAAC,CAAC;QAChC,IAAI,MAAM,CAAC,cAAc,EAAE;YACzB,IAAI,aAAa,GAAG,KAAK,CAAC;YAE1B,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE;gBACxE,IAAI,MAAM,CAAC,QAAQ,KAAK,WAAW,EAAE;oBACnC,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,QAAQ,GAAG,WAAW,CAAC;oBACzD,aAAa,GAAG,IAAI,CAAC;oBACrB,YAAY,GAAG,IAAI,CAAC;iBACrB;aACF;YAED,IAAI,aAAa,EAAE;gBACjB,IAAA,qBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;aAC5B;SACF;QAED,MAAM,QAAQ,GAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;QACnC,KAAK,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE;YACvD,IAAI,cAAc,GAAG,KAAK,CAAC;YAE3B,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAA,OAAO,CAAC,OAAO,mCAAI,EAAE,CAAC,EAAE;gBACxE,IAAI,MAAM,CAAC,QAAQ,KAAK,WAAW,EAAE;oBACnC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,QAAQ,GAAG,WAAW,CAAC;oBACnD,cAAc,GAAG,IAAI,CAAC;oBACtB,YAAY,GAAG,IAAI,CAAC;iBACrB;aACF;YAED,IAAI,cAAc,EAAE;gBAClB,IAAA,mCAA0B,EAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;aACxD;SACF;QAED,IAAI,YAAY,EAAE;YAChB,IAAA,qCAA4B,EAAC,IAAI,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,oBAAS,EAAE,CAAC,CAAC;SACpE;QAED,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;;CACzB;AA5CD,2CA4CC"}

package/src/migrations/update-15-9-0/update-testing-tsconfig.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+export declare function updateTestingTsconfigForJest(tree: Tree): Promise<void>;
+export default updateTestingTsconfigForJest;

package/src/migrations/update-15-9-0/update-testing-tsconfig.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateTestingTsconfigForJest = void 0;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const executor_options_utils_1 = require("@nx/devkit/src/generators/executor-options-utils");
+function updateTestingTsconfigForJest(tree) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const graph = yield (0, devkit_1.createProjectGraphAsync)();
+        const projects = (0, devkit_1.getProjects)(tree);
+        (0, executor_options_utils_1.forEachExecutorOptionsInGraph)(graph, '@nrwl/jest:jest', (options, projectName) => {
+            const projectConfig = projects.get(projectName);
+            if (!isJestPresetAngular(tree, options.jestConfig)) {
+                return;
+            }
+            const tsconfigPath = (0, devkit_1.joinPathFragments)(projectConfig.root, 'tsconfig.spec.json');
+            if (tree.exists(tsconfigPath)) {
+                (0, devkit_1.updateJson)(tree, tsconfigPath, (json) => {
+                    var _a, _b;
+                    var _c;
+                    (_a = json.compilerOptions) !== null && _a !== void 0 ? _a : (json.compilerOptions = {});
+                    (_b = (_c = json.compilerOptions).target) !== null && _b !== void 0 ? _b : (_c.target = 'es2016');
+                    return json;
+                }, { expectComments: true, allowTrailingComma: true });
+            }
+        });
+        yield (0, devkit_1.formatFiles)(tree);
+    });
+}
+exports.updateTestingTsconfigForJest = updateTestingTsconfigForJest;
+function isJestPresetAngular(tree, jestConfigPath) {
+    if (jestConfigPath && tree.exists(jestConfigPath)) {
+        const contents = tree.read(jestConfigPath, 'utf-8');
+        return contents.includes('jest-preset-angular');
+    }
+    return false;
+}
+exports.default = updateTestingTsconfigForJest;
+//# sourceMappingURL=update-testing-tsconfig.js.map

package/src/migrations/update-15-9-0/update-testing-tsconfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-testing-tsconfig.js","sourceRoot":"","sources":["../../../../../../packages/angular/src/migrations/update-15-9-0/update-testing-tsconfig.ts"],"names":[],"mappings":";;;;AAAA,uCAOoB;AACpB,6FAAiG;AAGjG,SAAsB,4BAA4B,CAAC,IAAU;;QAC3D,MAAM,KAAK,GAAG,MAAM,IAAA,gCAAuB,GAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;QACnC,IAAA,sDAA6B,EAC3B,KAAK,EACL,iBAAiB,EACjB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE;YACvB,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAEhD,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE;gBAClD,OAAO;aACR;YACD,MAAM,YAAY,GAAG,IAAA,0BAAiB,EACpC,aAAa,CAAC,IAAI,EAClB,oBAAoB,CACrB,CAAC;YAEF,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE;gBAC7B,IAAA,mBAAU,EACR,IAAI,EACJ,YAAY,EACZ,CAAC,IAAI,EAAE,EAAE;;;oBACP,MAAA,IAAI,CAAC,eAAe,oCAApB,IAAI,CAAC,eAAe,GAAK,EAAE,EAAC;oBAC5B,YAAA,IAAI,CAAC,eAAe,EAAC,MAAM,uCAAN,MAAM,GAAK,QAAQ,EAAC;oBAEzC,OAAO,IAAI,CAAC;gBACd,CAAC,EACD,EAAE,cAAc,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CACnD,CAAC;aACH;QACH,CAAC,CACF,CAAC;QAEF,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CAAA;AAlCD,oEAkCC;AAED,SAAS,mBAAmB,CAAC,IAAU,EAAE,cAAsB;IAC7D,IAAI,cAAc,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAEpD,OAAO,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;KACjD;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kBAAe,4BAA4B,CAAC"}

package/src/migrations/update-16-0-0/remove-library-generator-simple-module-name-option.d.ts

@@ -0,0 +1,2 @@
+import type { Tree } from '@nx/devkit';
+export default function removeLibraryGeneratorSimpleModuleNameOption(tree: Tree): Promise<void>;

package/src/migrations/update-16-0-0/remove-library-generator-simple-module-name-option.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+function removeLibraryGeneratorSimpleModuleNameOption(tree) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const nxJson = (0, devkit_1.readNxJson)(tree);
+        // update global config
+        const nxJsonUpdated = replaceSimpleModuleNameInConfig(nxJson);
+        if (nxJsonUpdated) {
+            (0, devkit_1.updateNxJson)(tree, nxJson);
+        }
+        // update project configs
+        const projects = (0, devkit_1.getProjects)(tree);
+        for (const [name, project] of projects) {
+            const projectUpdated = replaceSimpleModuleNameInConfig(project);
+            if (projectUpdated) {
+                (0, devkit_1.updateProjectConfiguration)(tree, name, project);
+            }
+        }
+        yield (0, devkit_1.formatFiles)(tree);
+    });
+}
+exports.default = removeLibraryGeneratorSimpleModuleNameOption;
+function replaceSimpleModuleNameInConfig(configObject) {
+    var _a, _b, _c, _d, _e;
+    var _f, _g;
+    if (!(configObject === null || configObject === void 0 ? void 0 : configObject.generators)) {
+        return false;
+    }
+    let updated = false;
+    if ((_b = (_a = configObject.generators['@nrwl/angular']) === null || _a === void 0 ? void 0 : _a['library']) === null || _b === void 0 ? void 0 : _b.simpleModuleName) {
+        (_c = (_f = configObject.generators['@nrwl/angular']['library']).simpleName) !== null && _c !== void 0 ? _c : (_f.simpleName = configObject.generators['@nrwl/angular']['library'].simpleModuleName);
+        delete configObject.generators['@nrwl/angular']['library'].simpleModuleName;
+        updated = true;
+    }
+    else if ((_d = configObject.generators['@nrwl/angular:library']) === null || _d === void 0 ? void 0 : _d.simpleModuleName) {
+        (_e = (_g = configObject.generators['@nrwl/angular:library']).simpleName) !== null && _e !== void 0 ? _e : (_g.simpleName = configObject.generators['@nrwl/angular:library'].simpleModuleName);
+        delete configObject.generators['@nrwl/angular:library'].simpleModuleName;
+        updated = true;
+    }
+    return updated;
+}
+//# sourceMappingURL=remove-library-generator-simple-module-name-option.js.map

package/src/migrations/update-16-0-0/remove-library-generator-simple-module-name-option.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-library-generator-simple-module-name-option.js","sourceRoot":"","sources":["../../../../../../packages/angular/src/migrations/update-16-0-0/remove-library-generator-simple-module-name-option.ts"],"names":[],"mappings":";;;AAKA,uCAMoB;AAEpB,SAA8B,4CAA4C,CACxE,IAAU;;QAEV,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,IAAI,CAAC,CAAC;QAEhC,uBAAuB;QACvB,MAAM,aAAa,GAAG,+BAA+B,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,aAAa,EAAE;YACjB,IAAA,qBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;SAC5B;QAED,yBAAyB;QACzB,MAAM,QAAQ,GAAG,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,QAAQ,EAAE;YACtC,MAAM,cAAc,GAAG,+BAA+B,CAAC,OAAO,CAAC,CAAC;YAChE,IAAI,cAAc,EAAE;gBAClB,IAAA,mCAA0B,EAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;aACjD;SACF;QAED,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CAAA;AArBD,+DAqBC;AAED,SAAS,+BAA+B,CACtC,YAIQ;;;IAER,IAAI,CAAC,CAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,UAAU,CAAA,EAAE;QAC7B,OAAO,KAAK,CAAC;KACd;IAED,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,IAAI,MAAA,MAAA,YAAY,CAAC,UAAU,CAAC,eAAe,CAAC,0CAAG,SAAS,CAAC,0CAAE,gBAAgB,EAAE;QAC3E,YAAA,YAAY,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC,EAAC,UAAU,uCAAV,UAAU,GAC5D,YAAY,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,gBAAgB,EAAC;QACvE,OAAO,YAAY,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,gBAAgB,CAAC;QAC5E,OAAO,GAAG,IAAI,CAAC;KAChB;SAAM,IACL,MAAA,YAAY,CAAC,UAAU,CAAC,uBAAuB,CAAC,0CAAE,gBAAgB,EAClE;QACA,YAAA,YAAY,CAAC,UAAU,CAAC,uBAAuB,CAAC,EAAC,UAAU,uCAAV,UAAU,GACzD,YAAY,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,gBAAgB,EAAC;QACpE,OAAO,YAAY,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,gBAAgB,CAAC;QACzE,OAAO,GAAG,IAAI,CAAC;KAChB;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/src/migrations/update-16-0-0-add-nx-packages/update-16-0-0-add-nx-packages.d.ts

@@ -0,0 +1,2 @@
+import { Tree } from '@nx/devkit';
+export default function replacePackage(tree: Tree): Promise<void>;

package/src/migrations/update-16-0-0-add-nx-packages/update-16-0-0-add-nx-packages.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const replace_package_1 = require("@nx/devkit/src/utils/replace-package");
+function replacePackage(tree) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        yield (0, replace_package_1.replaceNrwlPackageWithNxPackage)(tree, '@nrwl/angular', '@nx/angular');
+        yield (0, devkit_1.formatFiles)(tree);
+    });
+}
+exports.default = replacePackage;
+//# sourceMappingURL=update-16-0-0-add-nx-packages.js.map

package/src/migrations/update-16-0-0-add-nx-packages/update-16-0-0-add-nx-packages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-16-0-0-add-nx-packages.js","sourceRoot":"","sources":["../../../../../../packages/angular/src/migrations/update-16-0-0-add-nx-packages/update-16-0-0-add-nx-packages.ts"],"names":[],"mappings":";;;AAAA,uCAA+C;AAC/C,0EAAuF;AAEvF,SAA8B,cAAc,CAAC,IAAU;;QACrD,MAAM,IAAA,iDAA+B,EAAC,IAAI,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;QAE5E,MAAM,IAAA,oBAAW,EAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CAAA;AAJD,iCAIC"}

package/src/runtime/nx/data-persistence.d.ts

@@ -0,0 +1,271 @@
+import type { Type } from '@angular/core';
+import type { ActivatedRouteSnapshot } from '@angular/router';
+import type { Action } from '@ngrx/store';
+import type { Observable } from 'rxjs';
+export interface PessimisticUpdateOpts<T extends Array<unknown>, A> {
+    run(a: A, ...slices: [...T]): Observable<Action> | Action | void;
+    onError(a: A, e: any): Observable<any> | any;
+}
+export interface OptimisticUpdateOpts<T extends Array<unknown>, A> {
+    run(a: A, ...slices: [...T]): Observable<Action> | Action | void;
+    undoAction(a: A, e: any): Observable<Action> | Action;
+}
+export interface FetchOpts<T extends Array<unknown>, A> {
+    id?(a: A, ...slices: [...T]): any;
+    run(a: A, ...slices: [...T]): Observable<Action> | Action | void;
+    onError?(a: A, e: any): Observable<any> | any;
+}
+export interface HandleNavigationOpts<T extends Array<unknown>> {
+    run(a: ActivatedRouteSnapshot, ...slices: [...T]): Observable<Action> | Action | void;
+    onError?(a: ActivatedRouteSnapshot, e: any): Observable<any> | any;
+}
+export type ActionOrActionWithStates<T extends Array<unknown>, A> = A | [A, ...T];
+export type ActionOrActionWithState<T, A> = ActionOrActionWithStates<[T], A>;
+export type ActionStatesStream<T extends Array<unknown>, A> = Observable<ActionOrActionWithStates<T, A>>;
+export type ActionStateStream<T, A> = Observable<ActionOrActionWithStates<[T], A>>;
+/**
+ *
+ * @whatItDoes Handles pessimistic updates (updating the server first).
+ *
+ * Updating the server, when implemented naively, suffers from race conditions and poor error handling.
+ *
+ * `pessimisticUpdate` addresses these problems. It runs all fetches in order, which removes race conditions
+ * and forces the developer to handle errors.
+ *
+ * ## Example:
+ *
+ * ```typescript
+ * @Injectable()
+ * class TodoEffects {
+ *   updateTodo$ = createEffect(() =>
+ *     this.actions$.pipe(
+ *       ofType('UPDATE_TODO'),
+ *       pessimisticUpdate({
+ *         // provides an action
+ *         run: (action: UpdateTodo) => {
+ *           // update the backend first, and then dispatch an action that will
+ *           // update the client side
+ *           return this.backend.updateTodo(action.todo.id, action.todo).pipe(
+ *             map((updated) => ({
+ *               type: 'UPDATE_TODO_SUCCESS',
+ *               todo: updated,
+ *             }))
+ *           );
+ *         },
+ *         onError: (action: UpdateTodo, error: any) => {
+ *           // we don't need to undo the changes on the client side.
+ *           // we can dispatch an error, or simply log the error here and return `null`
+ *           return null;
+ *         },
+ *       })
+ *     )
+ *   );
+ *
+ *   constructor(private actions$: Actions, private backend: Backend) {}
+ * }
+ * ```
+ *
+ * Note that if you don't return a new action from the run callback, you must set the dispatch property
+ * of the effect to false, like this:
+ *
+ * ```typescript
+ * class TodoEffects {
+ *   updateTodo$ = createEffect(() =>
+ *     this.actions$.pipe(
+ *       //...
+ *     ), { dispatch: false }
+ *   );
+ * }
+ * ```
+ *
+ * @param opts
+ */
+export declare function pessimisticUpdate<T extends Array<unknown>, A extends Action>(opts: PessimisticUpdateOpts<T, A>): (source: ActionStatesStream<T, A>) => Observable<Action>;
+/**
+ *
+ * @whatItDoes Handles optimistic updates (updating the client first).
+ *
+ * It runs all fetches in order, which removes race conditions and forces the developer to handle errors.
+ *
+ * When using `optimisticUpdate`, in case of a failure, the developer has already updated the state locally,
+ * so the developer must provide an undo action.
+ *
+ * The error handling must be done in the callback, or by means of the undo action.
+ *
+ * ## Example:
+ *
+ * ```typescript
+ * @Injectable()
+ * class TodoEffects {
+ *   updateTodo$ = createEffect(() =>
+ *     this.actions$.pipe(
+ *       ofType('UPDATE_TODO'),
+ *       optimisticUpdate({
+ *         // provides an action
+ *         run: (action: UpdateTodo) => {
+ *           return this.backend.updateTodo(action.todo.id, action.todo).pipe(
+ *             mapTo({
+ *               type: 'UPDATE_TODO_SUCCESS',
+ *             })
+ *           );
+ *         },
+ *         undoAction: (action: UpdateTodo, error: any) => {
+ *           // dispatch an undo action to undo the changes in the client state
+ *           return {
+ *             type: 'UNDO_TODO_UPDATE',
+ *             todo: action.todo,
+ *           };
+ *         },
+ *       })
+ *     )
+ *   );
+ *
+ *   constructor(private actions$: Actions, private backend: Backend) {}
+ * }
+ * ```
+ *
+ * Note that if you don't return a new action from the run callback, you must set the dispatch property
+ * of the effect to false, like this:
+ *
+ * ```typescript
+ * class TodoEffects {
+ *   updateTodo$ = createEffect(() =>
+ *     this.actions$.pipe(
+ *       //...
+ *     ), { dispatch: false }
+ *   );
+ * }
+ * ```
+ *
+ * @param opts
+ */
+export declare function optimisticUpdate<T extends Array<unknown>, A extends Action>(opts: OptimisticUpdateOpts<T, A>): (source: ActionStatesStream<T, A>) => Observable<Action>;
+/**
+ *
+ * @whatItDoes Handles data fetching.
+ *
+ * Data fetching implemented naively suffers from race conditions and poor error handling.
+ *
+ * `fetch` addresses these problems. It runs all fetches in order, which removes race conditions
+ * and forces the developer to handle errors.
+ *
+ * ## Example:
+ *
+ * ```typescript
+ * @Injectable()
+ * class TodoEffects {
+ *   loadTodos$ = createEffect(() =>
+ *     this.actions$.pipe(
+ *       ofType('GET_TODOS'),
+ *       fetch({
+ *         // provides an action
+ *         run: (a: GetTodos) => {
+ *           return this.backend.getAll().pipe(
+ *             map((response) => ({
+ *               type: 'TODOS',
+ *               todos: response.todos,
+ *             }))
+ *           );
+ *         },
+ *         onError: (action: GetTodos, error: any) => {
+ *           // dispatch an undo action to undo the changes in the client state
+ *           return null;
+ *         },
+ *       })
+ *     )
+ *   );
+ *
+ *   constructor(private actions$: Actions, private backend: Backend) {}
+ * }
+ * ```
+ *
+ * This is correct, but because it set the concurrency to 1, it may not be performant.
+ *
+ * To fix that, you can provide the `id` function, like this:
+ *
+ * ```typescript
+ * @Injectable()
+ * class TodoEffects {
+ *   loadTodo$ = createEffect(() =>
+ *     this.actions$.pipe(
+ *       ofType('GET_TODO'),
+ *       fetch({
+ *         id: (todo: GetTodo) => {
+ *           return todo.id;
+ *         },
+ *         // provides an action
+ *         run: (todo: GetTodo) => {
+ *           return this.backend.getTodo(todo.id).map((response) => ({
+ *             type: 'LOAD_TODO_SUCCESS',
+ *             todo: response.todo,
+ *           }));
+ *         },
+ *         onError: (action: GetTodo, error: any) => {
+ *           // dispatch an undo action to undo the changes in the client state
+ *           return null;
+ *         },
+ *       })
+ *     )
+ *   );
+ *
+ *   constructor(private actions$: Actions, private backend: Backend) {}
+ * }
+ * ```
+ *
+ * With this setup, the requests for Todo 1 will run concurrently with the requests for Todo 2.
+ *
+ * In addition, if there are multiple requests for Todo 1 scheduled, it will only run the last one.
+ *
+ * @param opts
+ */
+export declare function fetch<T extends Array<unknown>, A extends Action>(opts: FetchOpts<T, A>): (source: ActionStatesStream<T, A>) => Observable<Action>;
+/**
+ * @whatItDoes Handles data fetching as part of router navigation.
+ *
+ * Data fetching implemented naively suffers from race conditions and poor error handling.
+ *
+ * `navigation` addresses these problems.
+ *
+ * It checks if an activated router state contains the passed in component type, and, if it does, runs the `run`
+ * callback. It provides the activated snapshot associated with the component and the current state. And it only runs
+ * the last request.
+ *
+ * ## Example:
+ *
+ * ```typescript
+ * @Injectable()
+ * class TodoEffects {
+ *   loadTodo$ = createEffect(() =>
+ *     this.actions$.pipe(
+ *       // listens for the routerNavigation action from @ngrx/router-store
+ *       navigation(TodoComponent, {
+ *         run: (activatedRouteSnapshot: ActivatedRouteSnapshot) => {
+ *           return this.backend
+ *             .fetchTodo(activatedRouteSnapshot.params['id'])
+ *             .pipe(
+ *               map((todo) => ({
+ *                 type: 'LOAD_TODO_SUCCESS',
+ *                 todo: todo,
+ *               }))
+ *             );
+ *         },
+ *         onError: (
+ *           activatedRouteSnapshot: ActivatedRouteSnapshot,
+ *           error: any
+ *         ) => {
+ *           // we can log and error here and return null
+ *           // we can also navigate back
+ *           return null;
+ *         },
+ *       })
+ *     )
+ *   );
+ *
+ *   constructor(private actions$: Actions, private backend: Backend) {}
+ * }
+ * ```
+ *
+ * @param component
+ * @param opts
+ */
+export declare function navigation<T extends Array<unknown>, A extends Action>(component: Type<any>, opts: HandleNavigationOpts<T>): (source: ActionStatesStream<T, A>) => Observable<Action>;