@nx/angular 0.0.0-pr-22179-271588f

package/src/utils/nx-devkit/route-utils.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addProviderToRoute = exports.addRoute = void 0;
+const js_1 = require("@nx/js");
+const ast_utils_1 = require("./ast-utils");
+const ensure_typescript_1 = require("@nx/js/src/utils/typescript/ensure-typescript");
+let tsModule;
+/**
+ * Add a new route to a routes definition
+ * @param tree Virtual Tree
+ * @param routesFile File containing the routes definition
+ * @param route Route to add
+ * @param lazy If Route should be lazy-loaded
+ * @param routesConst Used when eager-loading a route: Class name of the Component
+ * @param importPath Used when eager-loading a route: The import path to the Component
+ */
+function addRoute(tree, routesFile, route, lazy = true, routesConst, importPath) {
+    if (!tree.exists(routesFile)) {
+        throw new Error(`Path to parent routing declaration (${routesFile}) does not exist. Please ensure path is correct.`);
+    }
+    if (!tsModule) {
+        tsModule = (0, ensure_typescript_1.ensureTypescript)();
+    }
+    const { tsquery } = require('@phenomnomnominal/tsquery');
+    let routesFileContents = tree.read(routesFile, 'utf-8');
+    if (!lazy) {
+        let parentSourceFile = tsModule.createSourceFile(routesFile, routesFileContents, tsModule.ScriptTarget.Latest, true);
+        parentSourceFile = (0, js_1.insertImport)(tree, parentSourceFile, routesFile, routesConst, importPath);
+        routesFileContents = tree.read(routesFile, 'utf-8');
+    }
+    const ast = tsquery.ast(routesFileContents);
+    const ROUTES_ARRAY_SELECTOR = 'VariableDeclaration:has(ArrayType > TypeReference > Identifier[name=Route], Identifier[name=Routes]) > ArrayLiteralExpression';
+    const routesArrayNodes = tsquery(ast, ROUTES_ARRAY_SELECTOR, {
+        visitAllChildren: true,
+    });
+    const isRoutesArray = routesArrayNodes.length > 0;
+    if (!isRoutesArray) {
+        if (routesFileContents.includes('@NgModule')) {
+            const sourceFile = tsModule.createSourceFile(routesFile, routesFileContents, tsModule.ScriptTarget.Latest, true);
+            (0, ast_utils_1.addRouteToNgModule)(tree, routesFile, sourceFile, route);
+            return;
+        }
+        else {
+            throw new Error(`Routing file (${routesFile}) does not a routing configuration. Please ensure the parent contains a routing configuration.`);
+        }
+    }
+    const newRoutesFileContents = `${routesFileContents.slice(0, routesArrayNodes[0].getStart() + 1)}
+    ${route},${routesFileContents.slice(routesArrayNodes[0].getStart() + 1)}`;
+    tree.write(routesFile, newRoutesFileContents);
+}
+exports.addRoute = addRoute;
+/**
+ * Add a provider to a standalone routes definition
+ * @param tree Virtual Tree
+ * @param routesFile The file containing the routes definition
+ * @param routeToAddProviderTo The route to add the provider to
+ * @param providerToAdd The provider to add to the route
+ */
+function addProviderToRoute(tree, routesFile, routeToAddProviderTo, providerToAdd) {
+    if (!tree.exists(routesFile)) {
+        throw new Error(`Path to parent routing declaration (${routesFile}) does not exist. Please ensure path is correct.`);
+    }
+    (0, ensure_typescript_1.ensureTypescript)();
+    const { tsquery } = require('@phenomnomnominal/tsquery');
+    let routesFileContents = tree.read(routesFile, 'utf-8');
+    const ast = tsquery.ast(routesFileContents);
+    const ROUTES_ARRAY_SELECTOR = 'VariableDeclaration:has(ArrayType > TypeReference > Identifier[name=Route], Identifier[name=Routes]) > ArrayLiteralExpression';
+    const routesArrayNodes = tsquery(ast, ROUTES_ARRAY_SELECTOR, {
+        visitAllChildren: true,
+    });
+    const isRoutesArray = routesArrayNodes.length > 0;
+    if (!isRoutesArray) {
+        throw new Error(`Routing file (${routesFile}) does not a routing configuration. Please ensure the parent contains a routing configuration.`);
+    }
+    const ROUTE_SELECTOR = `ObjectLiteralExpression:has(PropertyAssignment:has(Identifier[name=path]) > StringLiteral[value=${routeToAddProviderTo}]):last-child`;
+    const ROUTE_PATH_PROVIDERS_SELECTOR = 'ObjectLiteralExpression > PropertyAssignment:has(Identifier[name=providers])';
+    const selectedRouteNodes = tsquery(routesArrayNodes[0], ROUTE_SELECTOR, {
+        visitAllChildren: true,
+    });
+    if (selectedRouteNodes.length === 0) {
+        throw new Error(`Could not find '${routeToAddProviderTo}' in routes definition.`);
+    }
+    for (const selectedRouteNode of selectedRouteNodes) {
+        const routeProivdersNodes = tsquery(selectedRouteNode, ROUTE_PATH_PROVIDERS_SELECTOR, {
+            visitAllChildren: true,
+        });
+        if (routeProivdersNodes.length === 0) {
+            const newFileContents = `${routesFileContents.slice(0, selectedRouteNode.getEnd() - 1)}${routesFileContents
+                .slice(0, selectedRouteNode.getEnd() - 1)
+                .trim()
+                .endsWith(',')
+                ? ''
+                : ', '}providers: [${providerToAdd}]${routesFileContents.slice(selectedRouteNode.getEnd() - 1, routesFileContents.length)}`;
+            tree.write(routesFile, newFileContents);
+        }
+        else {
+            const newFileContents = `${routesFileContents.slice(0, routeProivdersNodes[0].getEnd() - 1)}, ${providerToAdd}${routesFileContents.slice(routeProivdersNodes[0].getEnd() - 1, routesFileContents.length)}`;
+            tree.write(routesFile, newFileContents);
+        }
+    }
+}
+exports.addProviderToRoute = addProviderToRoute;

package/src/utils/nx-devkit/testing.d.ts

@@ -0,0 +1,14 @@
+import type { Tree } from '@nx/devkit';
+export interface AppConfig {
+    appName: string;
+    appModule: string;
+}
+export interface LibConfig {
+    name: string;
+    module: string;
+    barrel: string;
+}
+export declare function getAppConfig(): AppConfig;
+export declare function getLibConfig(): LibConfig;
+export declare function createApp(tree: Tree, appName: string, routing?: boolean): void;
+export declare function createLib(tree: Tree, libName: string): void;

package/src/utils/nx-devkit/testing.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLib = exports.createApp = exports.getLibConfig = exports.getAppConfig = void 0;
+const devkit_1 = require("@nx/devkit");
+var appConfig; // configure built in createApp()
+var libConfig;
+function getAppConfig() {
+    return appConfig;
+}
+exports.getAppConfig = getAppConfig;
+function getLibConfig() {
+    return libConfig;
+}
+exports.getLibConfig = getLibConfig;
+function createApp(tree, appName, routing = true) {
+    appName = (0, devkit_1.names)(appName).fileName;
+    // save for getAppDir() lookup by external *.spec.ts tests
+    appConfig = {
+        appName,
+        appModule: `${appName}/src/app/app.module.ts`,
+    };
+    tree.write(appConfig.appModule, `import { NgModule } from '@angular/core';
+import { BrowserModule } from '@angular/platform-browser';
+${routing ? "import { RouterModule } from '@angular/router'" : ''};
+import { AppComponent } from './app.component';
+@NgModule({
+  imports: [BrowserModule, ${routing ? 'RouterModule.forRoot([])' : ''}],
+  declarations: [AppComponent],
+  bootstrap: [AppComponent]
+})
+export class AppModule {}
+`);
+    tree.write(`${appName}/src/main.ts`, `import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
+
+import { AppModule } from './app/app.module';
+
+platformBrowserDynamic()
+  .bootstrapModule(AppModule)
+  .catch(err => console.log(err));
+  `);
+    tree.write(`${appName}/tsconfig.app.json`, JSON.stringify({
+        include: ['**/*.ts'],
+    }));
+    tree.write(`${appName}-e2e/tsconfig.e2e.json`, JSON.stringify({
+        include: ['../**/*.ts'],
+    }));
+    (0, devkit_1.addProjectConfiguration)(tree, appName, {
+        root: `${appName}`,
+        sourceRoot: `${appName}/src`,
+        targets: {
+            build: {
+                options: {
+                    main: `${appName}/src/main.ts`,
+                },
+            },
+            serve: {
+                options: {},
+            },
+        },
+        tags: [],
+    });
+}
+exports.createApp = createApp;
+function createLib(tree, libName) {
+    const { name, className, fileName, propertyName } = (0, devkit_1.names)(libName);
+    libConfig = {
+        name,
+        module: `${propertyName}/src/lib/${fileName}.module.ts`,
+        barrel: `${propertyName}/src/index.ts`,
+    };
+    tree.write(libConfig.module, `import { NgModule } from '@angular/core';
+import { CommonModule } from '@angular/common';
+@NgModule({
+  imports: [
+    CommonModule
+  ],
+  providers: []
+})
+export class ${className}Module { }
+  `);
+    tree.write(libConfig.barrel, `export * from './lib/${fileName}.module';
+`);
+}
+exports.createLib = createLib;

package/src/utils/public-api.d.ts

@@ -0,0 +1,2 @@
+export { isStandalone, addImportToComponent, addImportToDirective, addImportToPipe, addImportToModule, addProviderToBootstrapApplication, addProviderToAppConfig, addProviderToComponent, addProviderToModule, } from './nx-devkit/ast-utils';
+export { addRoute, addProviderToRoute } from './nx-devkit/route-utils';

package/src/utils/public-api.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addProviderToRoute = exports.addRoute = exports.addProviderToModule = exports.addProviderToComponent = exports.addProviderToAppConfig = exports.addProviderToBootstrapApplication = exports.addImportToModule = exports.addImportToPipe = exports.addImportToDirective = exports.addImportToComponent = exports.isStandalone = void 0;
+var ast_utils_1 = require("./nx-devkit/ast-utils");
+Object.defineProperty(exports, "isStandalone", { enumerable: true, get: function () { return ast_utils_1.isStandalone; } });
+Object.defineProperty(exports, "addImportToComponent", { enumerable: true, get: function () { return ast_utils_1.addImportToComponent; } });
+Object.defineProperty(exports, "addImportToDirective", { enumerable: true, get: function () { return ast_utils_1.addImportToDirective; } });
+Object.defineProperty(exports, "addImportToPipe", { enumerable: true, get: function () { return ast_utils_1.addImportToPipe; } });
+Object.defineProperty(exports, "addImportToModule", { enumerable: true, get: function () { return ast_utils_1.addImportToModule; } });
+Object.defineProperty(exports, "addProviderToBootstrapApplication", { enumerable: true, get: function () { return ast_utils_1.addProviderToBootstrapApplication; } });
+Object.defineProperty(exports, "addProviderToAppConfig", { enumerable: true, get: function () { return ast_utils_1.addProviderToAppConfig; } });
+Object.defineProperty(exports, "addProviderToComponent", { enumerable: true, get: function () { return ast_utils_1.addProviderToComponent; } });
+Object.defineProperty(exports, "addProviderToModule", { enumerable: true, get: function () { return ast_utils_1.addProviderToModule; } });
+var route_utils_1 = require("./nx-devkit/route-utils");
+Object.defineProperty(exports, "addRoute", { enumerable: true, get: function () { return route_utils_1.addRoute; } });
+Object.defineProperty(exports, "addProviderToRoute", { enumerable: true, get: function () { return route_utils_1.addProviderToRoute; } });

package/src/utils/targets.d.ts

@@ -0,0 +1,2 @@
+import { TargetConfiguration } from '@nx/devkit';
+export declare function allTargetOptions<T>(target: TargetConfiguration<T>): Iterable<[string | undefined, T]>;

package/src/utils/targets.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allTargetOptions = void 0;
+function* allTargetOptions(target) {
+    if (target.options) {
+        yield [undefined, target.options];
+    }
+    if (!target.configurations) {
+        return;
+    }
+    for (const [name, options] of Object.entries(target.configurations)) {
+        if (options !== undefined) {
+            yield [name, options];
+        }
+    }
+}
+exports.allTargetOptions = allTargetOptions;

package/src/utils/test-runners.d.ts

@@ -0,0 +1,9 @@
+export declare enum UnitTestRunner {
+    Jest = "jest",
+    None = "none"
+}
+export declare enum E2eTestRunner {
+    Cypress = "cypress",
+    Playwright = "playwright",
+    None = "none"
+}

package/src/utils/test-runners.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.E2eTestRunner = exports.UnitTestRunner = void 0;
+var UnitTestRunner;
+(function (UnitTestRunner) {
+    UnitTestRunner["Jest"] = "jest";
+    UnitTestRunner["None"] = "none";
+})(UnitTestRunner || (exports.UnitTestRunner = UnitTestRunner = {}));
+var E2eTestRunner;
+(function (E2eTestRunner) {
+    E2eTestRunner["Cypress"] = "cypress";
+    E2eTestRunner["Playwright"] = "playwright";
+    E2eTestRunner["None"] = "none";
+})(E2eTestRunner || (exports.E2eTestRunner = E2eTestRunner = {}));

package/src/utils/types.d.ts

@@ -0,0 +1,4 @@
+import type { ProjectConfiguration } from '@nx/devkit';
+export type AngularProjectConfiguration = ProjectConfiguration & {
+    prefix?: string;
+};

package/src/utils/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/src/utils/version-utils.d.ts

@@ -0,0 +1,3 @@
+import type { CompatPackageVersionNames, LatestPackageVersionNames, PackageCompatVersions, PackageLatestVersions } from './backward-compatible-versions';
+export declare function getPkgVersionForAngularMajorVersion(pkgVersionName: LatestPackageVersionNames | CompatPackageVersionNames, angularMajorVersion: number): string;
+export declare function getPkgVersionsForAngularMajorVersion(angularMajorVersion: number): PackageLatestVersions | PackageCompatVersions;

package/src/utils/version-utils.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPkgVersionsForAngularMajorVersion = exports.getPkgVersionForAngularMajorVersion = void 0;
+const semver_1 = require("semver");
+const backward_compatible_versions_1 = require("./backward-compatible-versions");
+const versions = require("./versions");
+const versions_1 = require("./versions");
+function getPkgVersionForAngularMajorVersion(pkgVersionName, angularMajorVersion) {
+    return angularMajorVersion < (0, semver_1.major)((0, semver_1.coerce)(versions_1.angularVersion))
+        ? backward_compatible_versions_1.backwardCompatibleVersions[`angularV${angularMajorVersion}`]?.[pkgVersionName] ?? versions[pkgVersionName]
+        : versions[pkgVersionName];
+}
+exports.getPkgVersionForAngularMajorVersion = getPkgVersionForAngularMajorVersion;
+function getPkgVersionsForAngularMajorVersion(angularMajorVersion) {
+    return angularMajorVersion < (0, semver_1.major)((0, semver_1.coerce)(versions_1.angularVersion))
+        ? backward_compatible_versions_1.backwardCompatibleVersions[`angularV${angularMajorVersion}`] ?? versions
+        : versions;
+}
+exports.getPkgVersionsForAngularMajorVersion = getPkgVersionsForAngularMajorVersion;

package/src/utils/versions.d.ts

@@ -0,0 +1,25 @@
+export declare const nxVersion: any;
+export declare const angularVersion = "~17.2.0";
+export declare const angularDevkitVersion = "~17.2.0";
+export declare const ngPackagrVersion = "~17.2.0";
+export declare const ngrxVersion = "~17.0.0";
+export declare const rxjsVersion = "~7.8.0";
+export declare const zoneJsVersion = "~0.14.3";
+export declare const angularJsVersion = "1.7.9";
+export declare const tsLibVersion = "^2.3.0";
+export declare const corsVersion = "~2.8.5";
+export declare const typesCorsVersion = "~2.8.5";
+export declare const expressVersion = "~4.18.2";
+export declare const typesExpressVersion = "4.17.14";
+export declare const browserSyncVersion = "^3.0.0";
+export declare const moduleFederationNodeVersion = "~1.0.5";
+export declare const angularEslintVersion = "~17.0.0";
+export declare const tailwindVersion = "^3.0.2";
+export declare const postcssVersion = "^8.4.5";
+export declare const postcssUrlVersion = "~10.1.3";
+export declare const autoprefixerVersion = "^10.4.0";
+export declare const tsNodeVersion = "10.9.1";
+export declare const jestPresetAngularVersion = "~14.0.3";
+export declare const typesNodeVersion = "18.16.9";
+export declare const jasmineMarblesVersion = "^0.9.2";
+export declare const jsoncEslintParserVersion = "^2.1.0";

package/src/utils/versions.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsoncEslintParserVersion = exports.jasmineMarblesVersion = exports.typesNodeVersion = exports.jestPresetAngularVersion = exports.tsNodeVersion = exports.autoprefixerVersion = exports.postcssUrlVersion = exports.postcssVersion = exports.tailwindVersion = exports.angularEslintVersion = exports.moduleFederationNodeVersion = exports.browserSyncVersion = exports.typesExpressVersion = exports.expressVersion = exports.typesCorsVersion = exports.corsVersion = exports.tsLibVersion = exports.angularJsVersion = exports.zoneJsVersion = exports.rxjsVersion = exports.ngrxVersion = exports.ngPackagrVersion = exports.angularDevkitVersion = exports.angularVersion = exports.nxVersion = void 0;
+exports.nxVersion = require('../../package.json').version;
+exports.angularVersion = '~17.2.0';
+exports.angularDevkitVersion = '~17.2.0';
+exports.ngPackagrVersion = '~17.2.0';
+exports.ngrxVersion = '~17.0.0';
+exports.rxjsVersion = '~7.8.0';
+exports.zoneJsVersion = '~0.14.3';
+exports.angularJsVersion = '1.7.9';
+exports.tsLibVersion = '^2.3.0';
+exports.corsVersion = '~2.8.5';
+exports.typesCorsVersion = '~2.8.5';
+exports.expressVersion = '~4.18.2';
+exports.typesExpressVersion = '4.17.14';
+exports.browserSyncVersion = '^3.0.0';
+exports.moduleFederationNodeVersion = '~1.0.5';
+exports.angularEslintVersion = '~17.0.0';
+exports.tailwindVersion = '^3.0.2';
+exports.postcssVersion = '^8.4.5';
+exports.postcssUrlVersion = '~10.1.3';
+exports.autoprefixerVersion = '^10.4.0';
+exports.tsNodeVersion = '10.9.1';
+exports.jestPresetAngularVersion = '~14.0.3';
+exports.typesNodeVersion = '18.16.9';
+exports.jasmineMarblesVersion = '^0.9.2';
+exports.jsoncEslintParserVersion = '^2.1.0';

package/tailwind.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generates a set of glob patterns based off the source root of the app and its dependencies
+ * @param dirPath workspace relative directory path that will be used to infer the parent project and dependencies
+ * @param fileGlobPattern pass a custom glob pattern to be used
+ */
+export declare function createGlobPatternsForDependencies(dirPath: string, fileGlobPattern?: string): string[];

package/tailwind.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGlobPatternsForDependencies = void 0;
+const generate_globs_1 = require("@nx/js/src/utils/generate-globs");
+/**
+ * Generates a set of glob patterns based off the source root of the app and its dependencies
+ * @param dirPath workspace relative directory path that will be used to infer the parent project and dependencies
+ * @param fileGlobPattern pass a custom glob pattern to be used
+ */
+function createGlobPatternsForDependencies(dirPath, fileGlobPattern = '/**/!(*.stories|*.spec).{ts,html}') {
+    try {
+        return (0, generate_globs_1.createGlobPatternsForDependencies)(dirPath, fileGlobPattern);
+    }
+    catch (e) {
+        /**
+         * It should not be possible to reach this point when the utility is invoked as part of the normal
+         * lifecycle of Nx executors. However, other tooling, such as the VSCode Tailwind IntelliSense plugin
+         * or JetBrains editors such as WebStorm, may execute the tailwind.config.js file in order to provide
+         * autocomplete features, for example.
+         *
+         * In order to best support that use-case, we therefore do not hard error when the ProjectGraph is
+         * fundamently unavailable in this tailwind-specific context.
+         */
+        console.warn('\nWARNING: There was an error creating glob patterns, returning an empty array\n' +
+            `${e.message}\n`);
+        return [];
+    }
+}
+exports.createGlobPatternsForDependencies = createGlobPatternsForDependencies;

package/testing/index.d.ts

@@ -0,0 +1 @@
+export { readAll, readFirst } from './src/testing-utils';

package/testing/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFirst = exports.readAll = void 0;
+var testing_utils_1 = require("./src/testing-utils");
+Object.defineProperty(exports, "readAll", { enumerable: true, get: function () { return testing_utils_1.readAll; } });
+Object.defineProperty(exports, "readFirst", { enumerable: true, get: function () { return testing_utils_1.readFirst; } });

package/testing/ng-package.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "../../../node_modules/ng-packagr/ng-package.schema.json",
+  "lib": {
+    "entryFile": "index.ts"
+  }
+}

package/testing/src/testing-utils.d.ts

@@ -0,0 +1,31 @@
+import type { Observable } from 'rxjs';
+/**
+ * @deprecated This will be removed in a later version of Nx. Since RxJS 7, use firstValueFrom(obs$.pipe(toArray())) or lastValueFrom(obs$.pipe(toArray())).
+ *
+ * @whatItDoes reads all the values from an observable and returns a promise
+ * with an array of all values. This should be used in combination with async/await.
+ *
+ * ## Example
+ *
+ * ```typescript
+ * const obs = of(1, 2, 3, 4);
+ * const res = await readAll(obs)
+ * expect(res).toEqual([1, 2, 3, 4]);
+ * ```
+ */
+export declare function readAll<T>(o: Observable<T>): Promise<T[]>;
+/**
+ * @deprecated This will be removed in a later version of Nx. Since RxJS 7, use firstValueFrom(obs$)
+ *
+ * @whatItDoes reads the first value from an observable and returns a promise
+ * with it. This should be used in combination with async/await.
+ *
+ * ## Example
+ *
+ * ```typescript
+ * const obs = of(1, 2, 3, 4);
+ * const res = await readFirst(obs)
+ * expect(res).toEqual(1);
+ * ```
+ */
+export declare function readFirst<T>(o: Observable<T>): Promise<T>;

package/testing/src/testing-utils.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFirst = exports.readAll = void 0;
+const operators_1 = require("rxjs/operators");
+/**
+ * @deprecated This will be removed in a later version of Nx. Since RxJS 7, use firstValueFrom(obs$.pipe(toArray())) or lastValueFrom(obs$.pipe(toArray())).
+ *
+ * @whatItDoes reads all the values from an observable and returns a promise
+ * with an array of all values. This should be used in combination with async/await.
+ *
+ * ## Example
+ *
+ * ```typescript
+ * const obs = of(1, 2, 3, 4);
+ * const res = await readAll(obs)
+ * expect(res).toEqual([1, 2, 3, 4]);
+ * ```
+ */
+function readAll(o) {
+    return o.pipe((0, operators_1.toArray)()).toPromise();
+}
+exports.readAll = readAll;
+/**
+ * @deprecated This will be removed in a later version of Nx. Since RxJS 7, use firstValueFrom(obs$)
+ *
+ * @whatItDoes reads the first value from an observable and returns a promise
+ * with it. This should be used in combination with async/await.
+ *
+ * ## Example
+ *
+ * ```typescript
+ * const obs = of(1, 2, 3, 4);
+ * const res = await readFirst(obs)
+ * expect(res).toEqual(1);
+ * ```
+ */
+function readFirst(o) {
+    return o.pipe((0, operators_1.first)()).toPromise();
+}
+exports.readFirst = readFirst;