Files
openclaw/scripts/generate-npm-package-lock.d.mts
Eugene Harold Krabs 0079fe80bb fix(plugin-npm): align bundled lock install strategy (#114620)
Co-authored-by: Peter Steinberger <steipete@gmail.com>
2026-07-29 00:20:32 -04:00

132 lines
3.7 KiB
TypeScript

#!/usr/bin/env node
/**
* Resolves the npm command invocation used by npm-lock generation.
*/
export function createNpmLockCommand(
args: string[],
options?: {
comSpec?: string;
env?: NodeJS.ProcessEnv;
execPath?: string;
existsSync?: (candidate: string) => boolean;
platform?: NodeJS.Platform;
},
): {
args: string[];
command: string;
env?: NodeJS.ProcessEnv;
shell: boolean;
windowsVerbatimArguments?: boolean;
};
/**
* Reads a positive integer env override for npm-lock subprocess limits.
*/
export function readPositiveIntEnv(
name: unknown,
fallback: unknown,
env?: NodeJS.ProcessEnv,
): number;
/**
* Builds execFileSync options with bounded timeout and output buffer limits.
*/
export function createNpmLockExecOptions(
invocation: unknown,
cwd: unknown,
env?: NodeJS.ProcessEnv,
): {
cwd: unknown;
env: unknown;
maxBuffer: number;
shell: unknown;
stdio: string[];
timeout: number;
windowsVerbatimArguments: unknown;
};
export function resolvePackageDirs(args: string[]): {
jobs: number;
packageDirs: unknown[];
};
export function createNpmPackageLockInstallStrategyArgs(options?: {
installStrategy?: "hoisted" | "nested" | "shallow" | "linked" | "" | null;
}): string[];
export function generateNpmPackageLock(
packageDir: string,
options?: {
installStrategy?: "hoisted" | "nested" | "shallow" | "linked" | "" | null;
},
): string;
export function resolveNpmLockJobs(
rawValue: unknown,
env?: NodeJS.ProcessEnv,
fallback?: number,
): number;
export function collectOverrideViolations(
lockfile: unknown,
overrideRules: unknown,
): {
path: string;
packageName: unknown;
actualVersion: unknown;
expectedVersion: unknown;
packagePath: {
name: unknown;
path: string;
}[];
}[];
export function collectPnpmLockViolations(
npmLock: unknown,
pnpmLockPackages?: Set<unknown>,
pnpmLockIntegrities?: Map<unknown, Set<unknown>>,
): {
path: string;
packageKey: string;
actualIntegrity?: unknown;
expectedIntegrities?: unknown[];
}[];
export function disableDependencyShrinkwrapOverrideConflictSources(
lockfile: unknown,
overrideRules: unknown,
): string[];
export function exactOverrideRulesFromOverrides(overrides: unknown): unknown;
export function exactVersionFromOverrideSpec(spec: unknown): string | null;
export function normalizeOverrides(overrides: unknown): Record<string, unknown>;
export function mergeOverrides(
packageOverrides: unknown,
workspaceOverrides: unknown,
pnpmLockOverrides: unknown,
): unknown;
export function applyPackageExtensionPeerMetadata(
lockfile: unknown,
packageExtensions?: unknown,
): unknown;
export function normalizeNpmVersionDrift<T>(lockfile: T): T;
export function packageJsonForNpmLock(
packageJson: Record<string, unknown>,
npmLockOverrides: Record<string, unknown>,
): {
dependencies?: Record<string, string>;
devDependencies?: Record<string, string>;
peerDependencies?: Record<string, string>;
[key: string]: unknown;
};
export function pnpmLockOverrideVersionForVersions(versions: unknown): unknown;
export function resolvePnpmLockOverridePlan(lockfile: unknown): {
conflictingPackageNames: string[];
scopedVersionOverrides: Record<string, unknown>;
versionOverrides: Record<string, string>;
};
export function parsePnpmPackageKey(packageKey: unknown): {
name: string;
version: string;
} | null;
export function parseLockPackagePath(lockPath: unknown): {
name: unknown;
path: string;
}[];
export function readNpmLockOverrides(): unknown;
export function shouldUseLegacyPeerDepsForNpmLock(
packageJson: unknown,
packageExtensions?: unknown,
): boolean;
export function npmLockPackageDirsForChangedPaths(changedPaths: string[]): string[];