Add receiver method, bump version, update changelog

Author: MicroFish91

api/CHANGELOG.md

@@ -6,6 +6,10 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/).
 
 ## Unreleased
 
+## [3.1.0] - 2025-11-10
+
+* Add optional receiver method to the type definition for `AzureExtensionApi`.
+
 ## [3.0.0] - 2025-10-06
 
 * Package is now a combined CJS+ESM package.

api/package-lock.json

@@ -1,6 +1,6 @@
 {
     "name": "@microsoft/vscode-azureresources-api",
-    "version": "3.0.0",
+    "version": "3.1.0",
     "description": "Type declarations and client library for the Azure Resources extension API",
     "repository": {
         "type": "git",

api/package.json

@@ -10,6 +10,15 @@ export interface AzureExtensionApi {
      * The API version for this extension. It should be versioned separately from the extension and ideally remains backwards compatible.
      */
     apiVersion: string;
+
+    /**
+     * Optional endpoint which Azure client extensions should implement in order to receive an Azure Resources API session.
+     *
+     * @param azureResourcesCredential - The credential to use when requesting the Azure Resources API
+     * @param clientCredential - The client verification credential initially generated by the client and passed to the Azure Resources API when requesting a new session.
+     * This credential is used to verify that the real Azure Resources extension is the one providing back the session credential.
+     */
+    receiveAzureResourcesApiSession?(azureResourcesCredential: string, clientCredential: string): void | Promise<void>;
 }
 
 export interface GetApiOptions {