Doppler

This JavaScript code defines a VS Code extension for interacting with Doppler, a service for managing secrets. Here's a summary:

Functionality:

• Doppler CLI Integration:

  • Installation: Installs the Doppler CLI if it's not already present, using either curl or wget along with gpg for verification.
  • Updating: Updates the Doppler CLI to the latest version.
  • Authentication:
    • Prompts users to log in to Doppler using the CLI.
    • Allows users to log out.
  • Workspace Scoping:
    • Prompts users to select a Doppler project and config to associate with their workspace.
    • Executes the doppler setup command with the chosen project and config.

• Environment Variable Autocompletion:

  • Provides autocompletion suggestions for environment variables based on secrets stored in the selected Doppler config.
  • Supports various languages (JavaScript, TypeScript, Ruby, Python, PHP, Go, Java, C#, Rust) and common environment variable access patterns within those languages.

• Secret Hover Information:

  • When hovering over an environment variable that matches a Doppler secret, displays a hover tooltip showing:
    • The Doppler project and config.
    • The secret's value (or "[RESTRICTED]" if the secret is restricted).

• Doppler Explorer View:

  • A tree view in the VS Code sidebar to browse Doppler projects, environments, and configs.
  • Allows users to open a config's secrets in a VS Code editor.

• Secrets Editor:

  • Enables editing Doppler secrets directly within VS Code.
  • Saves changes back to Doppler.
  • Presents secrets in YAML format with a header explaining the integration.

How it works:

• Dependencies:

  • Leverages various Node.js modules:
    • vscode: VS Code extension API.
    • child_process: For running external commands (Doppler CLI).
    • fs: For file system interaction.
    • os: For platform detection.
    • path: For working with file paths.
    • follow-redirects: For handling HTTP redirects.
    • stream: For working with data streams.
    • mime-types: For determining content types.
    • util: For various utility functions.
    • axios: For making HTTP requests to the Doppler API.
    • yaml: For parsing and stringifying YAML.
  • Defines several custom classes for managing:
    • Doppler authentication and configuration.
    • Doppler API requests.
    • Doppler resources (projects, environments, configs, secrets).
    • The Doppler Explorer view.
    • The Doppler file system provider and editor.

• Activation:

  • The extension activates when VS Code starts up.
  • It registers commands, completion providers, hover providers, and the Doppler Explorer view.

• Interaction Flow:

  • Users interact with the extension through commands (Install CLI, Login, Setup, etc.) and by editing files in the Doppler Explorer view.
  • The extension uses the Doppler CLI for most Doppler-related operations (authentication, scope configuration).
  • It uses the Doppler API to fetch projects, environments, configs, and secrets.
  • The Doppler file system provider handles reading and writing secrets to and from Doppler.
  • The autocompletion and hover features use regular expressions to detect environment variable access patterns and then query Doppler for matching secrets.

Overall, this extension provides a convenient way for developers to integrate Doppler into their VS Code workflow, simplifying the management of secrets in their projects.