feat: handle deep links to commands VSCODE-683 VSCODE-684 VSCODE-685

[nirinchev]

Description

Adds a URI handler that can be invoked with a command and optional query arguments, which will then execute said command. The following commands have been updated to accept arguments:

• connectWithURI
  • connectionString: connection string to connect with. If not supplied, a prompt will be shown
  • reuseExisting: true/false whether to always create a new connection or connect to an existing one with matching connection string.
  • name: optional name to assign to the connection
• removeConnection - only one of id/name/connectionString must be provided
  • connectionString: connection string to remove
  • name: name of connection to remove
  • id: id of connection to remove
  • force: true/false whether to prompt the user before removing

The URI handler will:

• Parse the supplied URI into the following components:
  • path will be mapped to command. The mdb. prefix will be automatically added if not present, so both /connectWithURI and /mdb.connectWithURI resolve to the same command.
  • query will be mapped to a params object which will be supplied as the only argument to executeCommand. Numbers and booleans will be parsed to their corresponding data type, everything else will be mapped to a string.
• Throw an error if the command is not exposed by the extension - that is, arbitrary commands cannot be executed that way.
• Report telemetry for each deeplink URI it processes, regardless of whether it's a success or not.
  • Event type is Deep Link Handled
  • Properties are { command: string, source?: string }
  • source is populated by the utm_source query argument, which is removed from the params passed to the command after it has been processed.

Checklist

• New tests and/or benchmarks are included

Motivation and Context

• Bugfix
• New feature
• Dependency update
• Misc

Types of changes

• Backport Needed
• Patch (non-breaking change which fixes an issue)
• Minor (non-breaking change which adds functionality)
• Major (fix or feature that would cause existing functionality to change)

[gagik]

Seems reasonable, minor note about the URL format.

[cveticm]

LGTM! Thanks for the quick work and all the additions! 🚀

[cveticm]

LGTM! 🚀 Thanks for adding telem and warning messaging!