@pnpm/installing.deps-installer 1101.9.0 → 1102.1.0

package/lib/install/extendInstallOptions.d.ts

@@ -18,6 +18,7 @@ export interface StrictInstallOptions {
     cleanupUnusedCatalogs: boolean;
     frozenLockfile: boolean;
     frozenLockfileIfExists: boolean;
+    frozenStore: boolean;
     enableGlobalVirtualStore: boolean;
     enablePnp: boolean;
     extraBinPaths: string[];
@@ -45,6 +46,13 @@ export interface StrictInstallOptions {
     preferFrozenLockfile: boolean;
     saveWorkspaceProtocol: boolean | 'rolling';
     lockfileCheck?: (prev: LockfileObject, next: LockfileObject) => void;
+    /**
+     * When true, resolve fully but write nothing to disk (no lockfile, no
+     * `node_modules`). The before/after wanted lockfiles are returned in the
+     * install result's `dryRunResult` so the caller can report what an install
+     * would change. Powers `pnpm install --dry-run`.
+     */
+    dryRun?: boolean;
     lockfileIncludeTarballUrl?: boolean;
     preferWorkspacePackages: boolean;
     preserveWorkspaceProtocol: boolean;
@@ -64,6 +72,8 @@ export interface StrictInstallOptions {
     engineStrict: boolean;
     allowBuilds?: Record<string, boolean | string>;
     nodeLinker: 'isolated' | 'hoisted' | 'pnp';
+    nodeExperimentalPackageMap: boolean;
+    nodePackageMapType: 'standard' | 'loose';
     nodeVersion?: string;
     packageExtensions: Record<string, PackageExtension>;
     ignoredOptionalDependencies: string[];
@@ -205,23 +215,33 @@ export interface StrictInstallOptions {
     packageVulnerabilityAudit?: PackageVulnerabilityAudit;
     blockExoticSubdeps?: boolean;
     /**
-     * Optional alternative install engine. When set, the frozen-install
-     * path invokes this callback instead of `headlessInstall`. The CLI
-     * layer constructs it (today: spawning the pacquet binary installed
-     * via `configDependencies` and forwarding pnpm's own CLI argv); the
-     * installer treats it as an opaque "do the install" hook so it
-     * doesn't need to know about pacquet's binary path, CLI surface, or
-     * any settings that only pacquet consumes.
+     * Optional alternative install engine. When set, the installer
+     * delegates the install to `run` instead of calling `headlessInstall`.
+     * The CLI layer constructs it (today: the pacquet binary installed via
+     * `configDependencies`, forwarding pnpm's own CLI argv); the installer
+     * treats it as an opaque "do the install" hook so it doesn't need to
+     * know about pacquet's binary path, CLI surface, or any settings that
+     * only pacquet consumes.
      *
-     * `filterResolvedProgress` tells the helper to drop the engine's
-     * own `pnpm:progress status:resolved` events because pnpm already
-     * emitted one per package during a preceding lockfileOnly resolve
-     * pass. The frozen-install path passes `false` (or nothing): no
-     * resolve pass ran, so the engine's events are the only source.
+     * `supportsResolution` is `true` when the engine can resolve
+     * dependencies itself (pacquet >= 0.11.7). When `false` the installer
+     * runs its own resolve pass first and the engine only materializes the
+     * written lockfile.
+     *
+     * `run`'s `filterResolvedProgress` tells the helper to drop the
+     * engine's own `pnpm:progress status:resolved` events because pnpm
+     * already emitted one per package during a preceding lockfileOnly
+     * resolve pass. `resolve` tells the engine to do the resolution
+     * itself (non-frozen install). The frozen/materialize paths leave
+     * both unset.
      */
-    runPacquet?: (opts?: {
-        filterResolvedProgress?: boolean;
-    }) => Promise<void>;
+    runPacquet?: {
+        supportsResolution: boolean;
+        run: (opts?: {
+            filterResolvedProgress?: boolean;
+            resolve?: boolean;
+        }) => Promise<void>;
+    };
     /**
      * If true, `mutateModules` does not emit the per-install `summary` log
      * event. Used by `pnpm add -g` when it runs multiple isolated installs

package/lib/install/extendInstallOptions.js

@@ -27,6 +27,7 @@ const defaults = (opts) => {
         force: false,
         forceFullResolution: false,
         frozenLockfile: false,
+        frozenStore: false,
         hoistPattern: undefined,
         publicHoistPattern: undefined,
         hooks: {},
@@ -47,6 +48,8 @@ const defaults = (opts) => {
         updateChecksums: false,
         nodeVersion: opts.nodeVersion,
         nodeLinker: 'isolated',
+        nodeExperimentalPackageMap: false,
+        nodePackageMapType: 'standard',
         overrides: {},
         ownLifecycleHooksStdio: 'inherit',
         ignoreCompatibilityDb: false,
@@ -144,6 +147,17 @@ export function extendOptions(opts) {
             throw new PnpmError('CONFIG_CONFLICT_LOCKFILE_ONLY_WITH_NO_LOCKFILE', `Cannot generate a ${WANTED_LOCKFILE} because lockfile is set to false`);
         }
     }
+    if (extendedOpts.frozenStore && extendedOpts.force) {
+        throw new PnpmError('CONFIG_CONFLICT_FROZEN_STORE_WITH_FORCE', 'Cannot use force together with frozenStore: --force re-imports packages into the store, which is opened read-only when frozenStore is enabled');
+    }
+    if (extendedOpts.frozenStore) {
+        // The side-effects cache is written into the store, which frozenStore opens
+        // read-only. Caching is an optimization, not a correctness requirement, so
+        // force it off rather than failing (the writable seed-build already
+        // populated it). Without this, a build under frozenStore (e.g. with the
+        // global virtual store disabled) would attempt a store write.
+        extendedOpts.sideEffectsCacheWrite = false;
+    }
     if (extendedOpts.userAgent.startsWith('npm/')) {
         extendedOpts.userAgent = `${extendedOpts.packageManager.name}/${extendedOpts.packageManager.version} ${extendedOpts.userAgent}`;
     }

package/lib/install/index.d.ts

@@ -2,6 +2,7 @@ import type { Catalogs } from '@pnpm/catalogs.types';
 import { PnpmError } from '@pnpm/error';
 import { type PinnedVersion, type UpdateMatchingFunction, type WantedDependency } from '@pnpm/installing.deps-resolver';
 import { type InstallationResultStats } from '@pnpm/installing.deps-restorer';
+import { type LockfileObject } from '@pnpm/lockfile.fs';
 import type { PreferredVersions, ResolutionPolicyViolation } from '@pnpm/resolving.resolver-base';
 import type { DependenciesField, DepPath, IgnoredBuilds, PeerDependencyIssues, ProjectId, ProjectManifest, ProjectRootDir, ReadPackageHook } from '@pnpm/types';
 import { type InstallOptions } from './extendInstallOptions.js';
@@ -47,6 +48,8 @@ export interface InstallResult {
     ignoredBuilds: IgnoredBuilds | undefined;
     /** Forwarded from {@link MutateModulesResult.resolutionPolicyViolations}. */
     resolutionPolicyViolations: ResolutionPolicyViolation[];
+    /** Forwarded from {@link MutateModulesResult.dryRunResult}. */
+    dryRunResult?: DryRunInstallResult;
 }
 export declare function install(manifest: ProjectManifest, opts: Opts): Promise<InstallResult>;
 export type MutatedProject = DependenciesMutation & {
@@ -64,6 +67,8 @@ export interface MutateModulesInSingleProjectResult {
     ignoredBuilds: IgnoredBuilds | undefined;
     /** Forwarded from {@link MutateModulesResult.resolutionPolicyViolations}. */
     resolutionPolicyViolations: ResolutionPolicyViolation[];
+    /** Forwarded from {@link MutateModulesResult.dryRunResult}. */
+    dryRunResult?: DryRunInstallResult;
 }
 export declare function mutateModulesInSingleProject(project: MutatedProject & {
     binsDir?: string;
@@ -86,6 +91,11 @@ export interface MutateModulesResult {
      * verifier reported a violation or no policy was active.
      */
     resolutionPolicyViolations: ResolutionPolicyViolation[];
+    /**
+     * Present only for a `dryRun` install: the before/after wanted lockfiles
+     * the resolve produced without writing, for the caller to diff.
+     */
+    dryRunResult?: DryRunInstallResult;
 }
 export declare function mutateModules(projects: MutatedProject[], maybeOpts: MutateModulesOptions): Promise<MutateModulesResult>;
 export declare function addDependenciesToPackage(manifest: ProjectManifest, dependencySelectors: string[], opts: Omit<InstallOptions, 'allProjects'> & {
@@ -117,6 +127,14 @@ export interface UpdatedProject {
     peerDependencyIssues?: PeerDependencyIssues;
     rootDir: ProjectRootDir;
 }
+/**
+ * The before/after wanted lockfiles a `dryRun` install resolved without
+ * writing. The caller diffs them to report what a real install would change.
+ */
+export interface DryRunInstallResult {
+    originalLockfile: LockfileObject;
+    wantedLockfile: LockfileObject;
+}
 export declare class IgnoredBuildsError extends PnpmError {
     constructor(ignoredBuilds: IgnoredBuilds);
 }