pnpm/installing/commands/src/fetch.ts

import { UNIVERSAL_OPTIONS } from '@pnpm/cli.common-cli-options-help'
import { docsUrl } from '@pnpm/cli.utils'
import type { Config, ConfigContext } from '@pnpm/config.reader'
import { type InstallOptions, mutateModulesInSingleProject } from '@pnpm/installing.deps-installer'
import { createStoreController, type CreateStoreControllerOptions } from '@pnpm/store.connection-manager'
import type { ProjectRootDir } from '@pnpm/types'
import { renderHelp } from 'render-help'

import { cliOptionsTypes } from './install.js'

export const rcOptionsTypes = cliOptionsTypes

export { cliOptionsTypes }

export const shorthands: Record<string, string> = {
  D: '--dev',
  P: '--production',
}

export const commandNames = ['fetch']

export function help (): string {
  return renderHelp({
    description: 'Fetch packages from a lockfile into virtual store, package manifest is ignored. WARNING! This is an experimental command. Breaking changes may be introduced in non-major versions of the CLI',
    descriptionLists: [
      {
        title: 'Options',

        list: [
          {
            description: 'Only development packages will be fetched',
            name: '--dev',
            shortAlias: '-D',
          },
          {
            description: 'Development packages will not be fetched',
            name: '--prod',
            shortAlias: '-P',
          },
          ...UNIVERSAL_OPTIONS,
        ],
      },
    ],
    url: docsUrl('fetch'),
    usages: ['pnpm fetch [--dev | --prod]'],
  })
}

type FetchCommandOptions = Pick<Config, 'production' | 'dev' | 'enableGlobalVirtualStore' | 'patchedDependencies'> & Pick<ConfigContext, 'rootProjectManifest' | 'rootProjectManifestDir'> & CreateStoreControllerOptions

export async function handler (opts: FetchCommandOptions): Promise<void> {
  const store = await createStoreController(opts)
  const include = {
    dependencies: opts.production !== false,
    devDependencies: opts.dev !== false,
    // when including optional deps, production is also required when perform headless install
    optionalDependencies: opts.production !== false,
  }
  await mutateModulesInSingleProject({
    manifest: {},
    mutation: 'install',
    pruneDirectDependencies: true,
    rootDir: process.cwd() as ProjectRootDir,
  }, {
    ...opts,
    ignorePackageManifest: true,
    ignoreLocalPackages: true,
    include,
    modulesCacheMaxAge: 0,
    pruneStore: true,
    storeController: store.ctrl,
    storeDir: store.dir,
    resolutionVerifiers: store.resolutionVerifiers,
    // Hoisting is skipped anyway,
    // so we store these empty patterns in node_modules/.modules.yaml
    // to let the subsequent install know that hoisting should be performed.
    hoistPattern: [],
    publicHoistPattern: [],
    // virtualStoreOnly skips post-import linking (symlinks, bins, hoisting)
    // even if ignorePackageManifest handling changes in the future.
    virtualStoreOnly: true,
    // Ensure fetch can populate the virtual store even when the user has
    // enable-modules-dir=false in their config — fetch always needs node_modules/.pnpm
    // (unless GVS is active, in which case enableModulesDir doesn't matter).
    enableModulesDir: true,
  } as InstallOptions)
}