@ohos-ports/nx 23.2.0-beta.0 → 23.2.1-beta.0

package/dist/src/command-line/repair/command-object.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.yargsRepairCommand = void 0;
-const handle_import_1 = require("../../utils/handle-import");
-const documentation_1 = require("../yargs-utils/documentation");
-const shared_options_1 = require("../yargs-utils/shared-options");
-exports.yargsRepairCommand = {
-    command: 'repair',
-    describe: `Repair any configuration that is no longer supported by Nx.
-
-    Specifically, this will run every migration within the \`nx\` package
-    against the current repository. Doing so should fix any configuration
-    details left behind if the repository was previously updated to a new
-    Nx version without using \`nx migrate\`.
-
-    If your repository has only ever updated to newer versions of Nx with
-    \`nx migrate\`, running \`nx repair\` should do nothing.
-  `,
-    builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)((0, shared_options_1.withVerbose)(yargs), 'repair'),
-    handler: async (args) => process.exit(await (await (0, handle_import_1.handleImport)('./repair.js', __dirname)).repair(args)),
-};

package/dist/src/command-line/repair/repair.d.ts

@@ -1,3 +0,0 @@
-export declare function repair(args: {
-    verbose: boolean;
-}, extraMigrations?: any[]): Promise<number>;

package/dist/src/command-line/repair/repair.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.repair = repair;
-const handle_errors_1 = require("../../utils/handle-errors");
-const migrate_1 = require("../migrate/migrate");
-const output_1 = require("../../utils/output");
-async function repair(args, extraMigrations = []) {
-    return (0, handle_errors_1.handleErrors)(args.verbose, async () => {
-        const migrationsJson = require(require.resolve('nx/migrations.json'));
-        const nxMigrations = Object.entries(migrationsJson.generators).reduce((agg, [name, migration]) => {
-            const skip = migration['x-repair-skip'];
-            if (!skip) {
-                agg.push({
-                    package: 'nx',
-                    name,
-                    description: migration.description,
-                    version: migration.version,
-                });
-            }
-            return agg;
-        }, []);
-        const migrations = [...nxMigrations, ...extraMigrations];
-        const { migrationsWithNoChanges, nextSteps } = await (0, migrate_1.executeMigrations)(process.cwd(), migrations, args.verbose, false, '');
-        if (migrationsWithNoChanges.length < migrations.length) {
-            output_1.output.success({
-                title: `Successfully repaired your configuration. This workspace is up to date!`,
-            });
-        }
-        else {
-            output_1.output.success({
-                title: `No changes were necessary. This workspace is up to date!`,
-            });
-        }
-        if (nextSteps.length) {
-            output_1.output.log({
-                title: 'Some repairs have additional information, see below.',
-                bodyLines: nextSteps.map((line) => `  - ${line}`),
-            });
-        }
-    });
-}

package/dist/src/command-line/report/command-object.d.ts

@@ -1,2 +0,0 @@
-import { CommandModule } from 'yargs';
-export declare const yargsReportCommand: CommandModule;

package/dist/src/command-line/report/command-object.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.yargsReportCommand = void 0;
-const handle_import_1 = require("../../utils/handle-import");
-exports.yargsReportCommand = {
-    command: 'report',
-    describe: 'Reports useful version numbers to copy into the Nx issue template.',
-    handler: async () => {
-        await (await (0, handle_import_1.handleImport)('./report.js', __dirname)).reportHandler();
-        process.exit(0);
-    },
-};

package/dist/src/command-line/report/report.d.ts

@@ -1,71 +0,0 @@
-import { PackageManager } from '../../utils/package-manager';
-import { PackageJson } from '../../utils/package-json';
-import { NxJsonConfiguration } from '../../config/nx-json';
-import { type NxKey } from '@nx/key';
-export declare const packagesWeCareAbout: string[];
-export declare const patternsWeIgnoreInCommunityReport: Array<string | RegExp>;
-/**
- * Reports relevant version numbers for adding to an Nx issue report
- *
- * @remarks
- *
- * Must be run within an Nx workspace
- *
- */
-export declare function reportHandler(): Promise<void>;
-export interface ReportData {
-    pm: PackageManager;
-    pmVersion: string;
-    nxKey: NxKey | null;
-    nxKeyError: Error | null;
-    powerpackPlugins: PackageJson[];
-    localPlugins: string[];
-    communityPlugins: PackageJson[];
-    registeredPlugins: string[];
-    daemon: {
-        available: boolean;
-        disabled: boolean;
-    } | {
-        error: unknown;
-    };
-    packageVersionsWeCareAbout: {
-        package: string;
-        version: string;
-    }[];
-    outOfSyncPackageGroup?: {
-        basePackage: string;
-        misalignedPackages: {
-            name: string;
-            version: string;
-        }[];
-        migrateTarget: string;
-    };
-    mismatchedNxVersions?: Array<{
-        version: string;
-        chain: string[];
-    }>;
-    projectGraphError?: Error | null;
-    nativeTarget: string | null;
-    cache: {
-        max: number;
-        used: number;
-    } | null;
-}
-export declare function getReportData(): Promise<ReportData>;
-interface OutOfSyncPackageGroup {
-    basePackage: string;
-    misalignedPackages: {
-        name: string;
-        version: string;
-    }[];
-    migrateTarget: string;
-}
-export declare function findMisalignedPackagesForPackage(base: PackageJson): undefined | OutOfSyncPackageGroup;
-export declare function findInstalledPowerpackPlugins(): PackageJson[];
-export declare function findInstalledCommunityPlugins(): PackageJson[];
-export declare function findRegisteredPluginsBeingUsed(nxJson: NxJsonConfiguration): string[];
-export declare function findInstalledPackagesWeCareAbout(): {
-    package: string;
-    version: string;
-}[];
-export {};

package/dist/src/command-line/report/report.js

@@ -1,405 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.patternsWeIgnoreInCommunityReport = exports.packagesWeCareAbout = void 0;
-exports.reportHandler = reportHandler;
-exports.getReportData = getReportData;
-exports.findMisalignedPackagesForPackage = findMisalignedPackagesForPackage;
-exports.findInstalledPowerpackPlugins = findInstalledPowerpackPlugins;
-exports.findInstalledCommunityPlugins = findInstalledCommunityPlugins;
-exports.findRegisteredPluginsBeingUsed = findRegisteredPluginsBeingUsed;
-exports.findInstalledPackagesWeCareAbout = findInstalledPackagesWeCareAbout;
-const tslib_1 = require("tslib");
-const pc = tslib_1.__importStar(require("picocolors"));
-const output_1 = require("../../utils/output");
-const package_manager_1 = require("../../utils/package-manager");
-const fileutils_1 = require("../../utils/fileutils");
-const package_json_1 = require("../../utils/package-json");
-const local_plugins_1 = require("../../utils/plugins/local-plugins");
-const project_graph_1 = require("../../project-graph/project-graph");
-const semver_1 = require("semver");
-const installed_plugins_1 = require("../../utils/plugins/installed-plugins");
-const installation_directory_1 = require("../../utils/installation-directory");
-const nx_json_1 = require("../../config/nx-json");
-const error_types_1 = require("../../project-graph/error-types");
-const operators_1 = require("../../project-graph/operators");
-const versions_1 = require("../../utils/versions");
-const nx_key_1 = require("../../utils/nx-key");
-const cache_1 = require("../../tasks-runner/cache");
-const client_1 = require("../../daemon/client/client");
-const nx_package_group_1 = require("../../utils/nx-package-group");
-const nxPackageJson = (0, fileutils_1.readJsonFile)(require.resolve('nx/package.json'));
-exports.packagesWeCareAbout = [
-    'lerna',
-    ...(0, nx_package_group_1.readNxPackageGroup)(),
-    '@nrwl/schematics', // manually added since we don't publish it anymore.
-    'typescript',
-];
-exports.patternsWeIgnoreInCommunityReport = [
-    ...exports.packagesWeCareAbout,
-    new RegExp('@nx/powerpack*'),
-    '@schematics/angular',
-    new RegExp('@angular/*'),
-    '@nestjs/schematics',
-];
-const LINE_SEPARATOR = '---------------------------------------';
-/**
- * Reports relevant version numbers for adding to an Nx issue report
- *
- * @remarks
- *
- * Must be run within an Nx workspace
- *
- */
-async function reportHandler() {
-    const { pm, pmVersion, nxKey, nxKeyError, localPlugins, powerpackPlugins, communityPlugins, registeredPlugins, packageVersionsWeCareAbout, outOfSyncPackageGroup, mismatchedNxVersions, projectGraphError, nativeTarget, cache, daemon, } = await getReportData();
-    const fields = [
-        ['Node', process.versions.node],
-        ['OS', `${process.platform}-${process.arch}`],
-        ['Native Target', nativeTarget ?? 'Unavailable'],
-        [pm, pmVersion],
-        [
-            'daemon',
-            'error' in daemon
-                ? `Error: ${daemon.error}`
-                : daemon.disabled
-                    ? 'Disabled'
-                    : daemon.available
-                        ? 'Available'
-                        : 'Unavailable',
-        ],
-    ];
-    let padding = Math.max(...fields.map((f) => f[0].length));
-    const bodyLines = fields.map(([field, value]) => `${field.padEnd(padding)}  : ${value}`);
-    bodyLines.push('');
-    padding =
-        Math.max(...packageVersionsWeCareAbout.map((x) => x.package.length)) + 1;
-    packageVersionsWeCareAbout.forEach((p) => {
-        bodyLines.push(`${pc.green(p.package.padEnd(padding))} : ${pc.bold(p.version)}`);
-    });
-    if (nxKey) {
-        bodyLines.push('');
-        bodyLines.push(LINE_SEPARATOR);
-        bodyLines.push(pc.green('Nx key licensed packages'));
-        bodyLines.push((0, nx_key_1.createNxKeyLicenseeInformation)(nxKey));
-        if (nxKey.realExpiresAt || nxKey.expiresAt) {
-            const licenseExpiryDate = new Date((nxKey.realExpiresAt ?? nxKey.expiresAt) * 1000);
-            // license is not expired
-            if (licenseExpiryDate.getTime() >= Date.now()) {
-                if ('perpetualNxVersion' in nxKey) {
-                    bodyLines.push(`License expires on ${licenseExpiryDate.toLocaleDateString()}, but will continue to work with Nx ${nxKey.perpetualNxVersion} and below.`);
-                }
-                else {
-                    bodyLines.push(`License expires on ${licenseExpiryDate.toLocaleDateString()}.`);
-                }
-            }
-            else {
-                if ('perpetualNxVersion' in nxKey) {
-                    bodyLines.push(`License expired on ${licenseExpiryDate.toLocaleDateString()}, but will continue to work with Nx ${nxKey.perpetualNxVersion} and below.`);
-                }
-                else {
-                    bodyLines.push(`License expired on ${licenseExpiryDate.toLocaleDateString()}.`);
-                }
-            }
-        }
-        bodyLines.push('');
-        padding =
-            Math.max(...powerpackPlugins.map((powerpackPlugin) => powerpackPlugin.name.length)) + 1;
-        for (const powerpackPlugin of powerpackPlugins) {
-            bodyLines.push(`${pc.green(powerpackPlugin.name.padEnd(padding))} : ${pc.bold(powerpackPlugin.version)}`);
-        }
-        bodyLines.push('');
-    }
-    else if (nxKeyError) {
-        bodyLines.push('');
-        bodyLines.push(pc.red('Nx key'));
-        bodyLines.push(LINE_SEPARATOR);
-        bodyLines.push(nxKeyError.message);
-        bodyLines.push('');
-    }
-    if (registeredPlugins.length) {
-        bodyLines.push(LINE_SEPARATOR);
-        bodyLines.push('Registered Plugins:');
-        for (const plugin of registeredPlugins) {
-            bodyLines.push(`${pc.green(plugin)}`);
-        }
-    }
-    if (communityPlugins.length) {
-        bodyLines.push(LINE_SEPARATOR);
-        padding = Math.max(...communityPlugins.map((x) => x.name.length)) + 1;
-        bodyLines.push('Community plugins:');
-        communityPlugins.forEach((p) => {
-            bodyLines.push(`${pc.green(p.name.padEnd(padding))}: ${pc.bold(p.version)}`);
-        });
-    }
-    if (localPlugins.length) {
-        bodyLines.push(LINE_SEPARATOR);
-        bodyLines.push('Local workspace plugins:');
-        for (const plugin of localPlugins) {
-            bodyLines.push(`${pc.green(plugin)}`);
-        }
-    }
-    if (cache) {
-        bodyLines.push(LINE_SEPARATOR);
-        bodyLines.push(`Cache Usage: ${(0, cache_1.formatCacheSize)(cache.used)} / ${cache.max === 0 ? '∞' : (0, cache_1.formatCacheSize)(cache.max)}`);
-    }
-    if (outOfSyncPackageGroup) {
-        bodyLines.push(LINE_SEPARATOR);
-        bodyLines.push(`The following packages should match the installed version of ${outOfSyncPackageGroup.basePackage}`);
-        for (const pkg of outOfSyncPackageGroup.misalignedPackages) {
-            bodyLines.push(`  - ${pkg.name}@${pkg.version}`);
-        }
-        bodyLines.push('');
-        bodyLines.push(`To fix this, run \`nx migrate ${outOfSyncPackageGroup.migrateTarget}\``);
-    }
-    if (mismatchedNxVersions && mismatchedNxVersions.length > 0) {
-        bodyLines.push(LINE_SEPARATOR);
-        bodyLines.push(pc.yellow('⚠️ Multiple Nx versions detected'));
-        bodyLines.push('');
-        bodyLines.push(`Your workspace uses nx@${versions_1.nxVersion}, but other packages depend on a different version:`);
-        for (const { version, chain } of mismatchedNxVersions) {
-            if (chain.length === 0) {
-                bodyLines.push(`  - ${pc.bold(`nx@${version}`)}`);
-            }
-            else {
-                bodyLines.push(`  - ${chain.reverse().join(' → ')} → ${pc.bold(`nx@${version}`)}`);
-            }
-        }
-        bodyLines.push('');
-        bodyLines.push('These packages should not have nx as a dependency. Please report this issue to the package maintainers.');
-        const whyCommand = (0, package_manager_1.getPackageManagerCommand)(pm).why;
-        for (const { version } of mismatchedNxVersions) {
-            bodyLines.push(`Run \`${whyCommand} nx@${version}\` for more details.`);
-        }
-    }
-    if (projectGraphError) {
-        bodyLines.push(LINE_SEPARATOR);
-        bodyLines.push('⚠️ Unable to construct project graph.');
-        bodyLines.push(projectGraphError.message);
-        bodyLines.push(projectGraphError.stack);
-    }
-    output_1.output.log({
-        title: 'Report complete - copy this into the issue template',
-        bodyLines,
-    });
-}
-function findDependencyChain(graph, targetNode) {
-    const reversedGraph = (0, operators_1.reverse)(graph);
-    // BFS to find shortest path to root dependency
-    const queue = [
-        { node: targetNode, path: [] },
-    ];
-    const visited = new Set();
-    while (queue.length > 0) {
-        const { node, path } = queue.shift();
-        if (visited.has(node))
-            continue;
-        visited.add(node);
-        const deps = reversedGraph.dependencies[node] || [];
-        // Check for unvisited dependents
-        const unvisitedDeps = deps.filter((dep) => !visited.has(dep.target));
-        // No unvisited dependents - this is our shortest path
-        if (unvisitedDeps.length === 0) {
-            return path;
-        }
-        for (const dep of unvisitedDeps) {
-            const depName = graph.externalNodes?.[dep.target]?.data?.packageName ?? dep.target;
-            queue.push({
-                node: dep.target,
-                path: [...path, depName],
-            });
-        }
-    }
-    return [];
-}
-function findMismatchedNxVersions(graph) {
-    if (!graph || !graph.externalNodes) {
-        return [];
-    }
-    const result = [];
-    // Find all nx package versions that don't match the workspace version
-    for (const nodeName of Object.keys(graph.externalNodes)) {
-        const node = graph.externalNodes[nodeName];
-        if (node.data?.packageName === 'nx') {
-            const version = node.data.version || 'unknown';
-            if (version !== versions_1.nxVersion) {
-                const chain = findDependencyChain(graph, nodeName);
-                result.push({ version, chain });
-            }
-        }
-    }
-    return result;
-}
-async function getReportData() {
-    const pm = (0, package_manager_1.detectPackageManager)();
-    const pmVersion = (0, package_manager_1.getPackageManagerVersion)(pm);
-    const { graph, error: projectGraphError } = await tryGetProjectGraph();
-    const nxJson = (0, nx_json_1.readNxJson)();
-    const localPlugins = await findLocalPlugins(graph, nxJson);
-    const powerpackPlugins = findInstalledPowerpackPlugins();
-    const communityPlugins = findInstalledCommunityPlugins();
-    const registeredPlugins = findRegisteredPluginsBeingUsed(nxJson);
-    const packageVersionsWeCareAbout = findInstalledPackagesWeCareAbout();
-    packageVersionsWeCareAbout.unshift({
-        package: 'nx',
-        version: nxPackageJson.version,
-    });
-    if (globalThis.GLOBAL_NX_VERSION) {
-        packageVersionsWeCareAbout.unshift({
-            package: 'nx (global)',
-            version: globalThis.GLOBAL_NX_VERSION,
-        });
-    }
-    const outOfSyncPackageGroup = findMisalignedPackagesForPackage(nxPackageJson);
-    const mismatchedNxVersions = findMismatchedNxVersions(graph);
-    const native = isNativeAvailable();
-    let nxKey = null;
-    let nxKeyError = null;
-    try {
-        nxKey = await (0, nx_key_1.getNxKeyInformation)();
-    }
-    catch (e) {
-        if (!(e instanceof nx_key_1.NxKeyNotInstalledError)) {
-            nxKeyError = e;
-        }
-    }
-    let cache = (0, cache_1.dbCacheEnabled)()
-        ? {
-            max: (0, cache_1.resolveMaxCacheSize)(nxJson),
-            used: new cache_1.DbCache({ nxCloudRemoteCache: null }).getUsedCacheSpace(),
-        }
-        : null;
-    return {
-        pm,
-        nxKey,
-        nxKeyError,
-        powerpackPlugins,
-        pmVersion,
-        localPlugins,
-        communityPlugins,
-        registeredPlugins,
-        packageVersionsWeCareAbout,
-        outOfSyncPackageGroup,
-        mismatchedNxVersions,
-        projectGraphError,
-        nativeTarget: native ? native.getBinaryTarget() : null,
-        cache,
-        daemon: await getDaemonStatus(),
-    };
-}
-async function getDaemonStatus() {
-    try {
-        const enabled = client_1.daemonClient.enabled();
-        const available = enabled && (await client_1.daemonClient.isServerAvailable());
-        return {
-            available,
-            disabled: !enabled,
-        };
-    }
-    catch (e) {
-        return {
-            error: e,
-        };
-    }
-}
-async function tryGetProjectGraph() {
-    try {
-        return { graph: await (0, project_graph_1.createProjectGraphAsync)() };
-    }
-    catch (error) {
-        if (error instanceof error_types_1.ProjectGraphError) {
-            return {
-                graph: error.getPartialProjectGraph(),
-                error: error,
-            };
-        }
-        return {
-            error,
-        };
-    }
-}
-async function findLocalPlugins(projectGraph, nxJson) {
-    try {
-        const localPlugins = await (0, local_plugins_1.getLocalWorkspacePlugins)((0, project_graph_1.readProjectsConfigurationFromProjectGraph)(projectGraph), nxJson);
-        return Array.from(localPlugins.keys());
-    }
-    catch {
-        return [];
-    }
-}
-function readPackageJson(p) {
-    try {
-        return (0, package_json_1.readModulePackageJson)(p, (0, installation_directory_1.getNxRequirePaths)()).packageJson;
-    }
-    catch {
-        return null;
-    }
-}
-function readPackageVersion(p) {
-    return readPackageJson(p)?.version;
-}
-function findMisalignedPackagesForPackage(base) {
-    const misalignedPackages = [];
-    let migrateTarget = base.version;
-    const { packageGroup } = (0, package_json_1.readNxMigrateConfig)(base);
-    for (const entry of packageGroup ?? []) {
-        const { package: packageName, version } = entry;
-        // should be aligned
-        if (version === '*') {
-            const installedVersion = readPackageVersion(packageName);
-            if (installedVersion && installedVersion !== base.version) {
-                if ((0, semver_1.valid)(installedVersion) && (0, semver_1.gt)(installedVersion, migrateTarget)) {
-                    migrateTarget = installedVersion;
-                }
-                misalignedPackages.push({
-                    name: packageName,
-                    version: installedVersion,
-                });
-            }
-        }
-    }
-    return misalignedPackages.length
-        ? {
-            basePackage: base.name,
-            misalignedPackages,
-            migrateTarget: `${base.name}@${migrateTarget}`,
-        }
-        : undefined;
-}
-function findInstalledPowerpackPlugins() {
-    const installedPlugins = (0, installed_plugins_1.findInstalledPlugins)();
-    return installedPlugins.filter((dep) => new RegExp('@nx/powerpack*|@nx/(.+)-cache|@nx/(conformance|owners|enterprise*)').test(dep.name));
-}
-function findInstalledCommunityPlugins() {
-    const installedPlugins = (0, installed_plugins_1.findInstalledPlugins)();
-    return installedPlugins.filter((dep) => dep.name !== 'nx' &&
-        !exports.patternsWeIgnoreInCommunityReport.some((pattern) => typeof pattern === 'string'
-            ? pattern === dep.name
-            : pattern.test(dep.name)));
-}
-function findRegisteredPluginsBeingUsed(nxJson) {
-    if (!nxJson.plugins) {
-        return [];
-    }
-    return nxJson.plugins.map((plugin) => typeof plugin === 'object' ? plugin.plugin : plugin);
-}
-function findInstalledPackagesWeCareAbout() {
-    const packagesWeMayCareAbout = {};
-    for (const pkg of exports.packagesWeCareAbout) {
-        const v = readPackageVersion(pkg);
-        if (v) {
-            packagesWeMayCareAbout[pkg] = v;
-        }
-    }
-    return Object.entries(packagesWeMayCareAbout).map(([pkg, version]) => ({
-        package: pkg,
-        version,
-    }));
-}
-function isNativeAvailable() {
-    try {
-        return require('../../native');
-    }
-    catch {
-        return false;
-    }
-}

package/dist/src/command-line/reset/command-object.d.ts

@@ -1,8 +0,0 @@
-import { CommandModule } from 'yargs';
-export type ResetCommandOptions = {
-    onlyCache?: boolean;
-    onlyDaemon?: boolean;
-    onlyWorkspaceData?: boolean;
-    onlyCloud?: boolean;
-};
-export declare const yargsResetCommand: CommandModule<Record<string, unknown>, ResetCommandOptions>;

package/dist/src/command-line/reset/command-object.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.yargsResetCommand = void 0;
-const handle_import_1 = require("../../utils/handle-import");
-exports.yargsResetCommand = {
-    command: 'reset',
-    describe: 'Clears cached Nx artifacts and metadata about the workspace and shuts down the Nx Daemon.',
-    aliases: ['clear-cache'],
-    builder: (yargs) => yargs
-        .option('onlyCache', {
-        description: 'Clears the Nx cache directory. This will remove all local cache entries for tasks, but will not affect the remote cache.',
-        type: 'boolean',
-    })
-        .option('onlyDaemon', {
-        description: 'Stops the Nx Daemon and clears its workspace data, it will be restarted fresh when the next Nx command is run.',
-        type: 'boolean',
-    })
-        .option('onlyCloud', {
-        description: 'Resets the Nx Cloud client. NOTE: Does not clear the remote cache.',
-        type: 'boolean',
-    })
-        .option('onlyWorkspaceData', {
-        description: 'Clears the workspace data directory. Used by Nx to store cached data about the current workspace (e.g. partial results, incremental data, etc).',
-        type: 'boolean',
-    }),
-    handler: async (argv) => (await (0, handle_import_1.handleImport)('./reset.js', __dirname)).resetHandler(argv),
-};

package/dist/src/command-line/reset/reset.d.ts

@@ -1,2 +0,0 @@
-import { ResetCommandOptions } from './command-object';
-export declare function resetHandler(args: ResetCommandOptions): Promise<void>;