Vigia

Upgrading dotenv from 17.x to 18.x

Comparison of the public API of dotenv 17.4.2 and 18.0.10, computed automatically from their TypeScript types. A changed signature is a candidate for a breaking change, not a certainty.

Summary

Removed import paths0
Removed exports1
Changed signatures2
Removed class or interface members1
Changed class or interface members0
Newly deprecated0
Requirement changes (engines, peer dependencies)1
New exports1

Removed exports

importexportkindBefore
dotenvdecryptfunction(encrypted: string, keyStr: string): string

Changed signatures

exportBeforeAfter
dotenv · parse<T extends DotenvParseOutput = DotenvParseOutput>(src: any): T<T extends DotenvParseOutput = DotenvParseOutput>(src: any, options?: DotenvParseOptions | undefined): T
dotenv · DotenvErrorError & { code: "MISSING_DATA" | "INVALID_DOTENV_KEY" | "NOT_FOUND_DOTENV_ENVIRONMENT" | "DECRYPTION_FAILED" | "OBJECT_REQUIRED"; }Error & { code: "OBJECT_REQUIRED" | (string & {}); }

Removed class or interface members

memberimportBefore
DotenvConfigOptions.DOTENV_KEYdotenvstring | undefined

Changed class or interface members

None detected.

Newly deprecated

None detected.

Requirement changes (engines, peer dependencies)

BeforeAfter
engines.node>=12—
New exports (1)
importexportkind
dotenvDotenvParseOptionsinterface

Give your AI agent these facts

Vigia is a free MCP server: your coding agent checks versions, breaking changes and vulnerabilities before it writes code. No signup, no API key.

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

Add to CursorAdd to VS Code★ Star on GitHub

Any other MCP client
{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

Agent skill (SKILL.md): tells the agent when to use Vigia · GitHub Action for pull requests

Frequently asked questions

What are the breaking changes when upgrading dotenv from 17 to 18?

Between dotenv 17.4.2 and 18.0.10, Vigia found 1 removed exports, 2 changed signatures and 1 removed or changed class or interface members.

What became deprecated in dotenv 18?

0 exports or members are newly marked as deprecated in dotenv 18.0.10.

For agents

GET https://vigia.coredls.cloud/v1/packages/npm/dotenv/upgrade?from=17.4.2&to=18.0.10