feat(typespec-metadata): add apiVersion field using TCGC resolution

Add apiVersion to LanguagePackageMetadata interface, resolved via
createSdkContext from @azure-tools/typespec-client-generator-core.

Resolution logic:
- Map size > 1 → "multiple-versions"
- Map size == 1 → the single value ("all" or actual version string)
- Empty/undefined → undefined

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: c95a24d5-2785-44e4-9599-ac2f5cb37a2c

Author: iscai-msft

packages/typespec-metadata/package.json

@@ -47,9 +47,11 @@
     "yaml": "catalog:"
   },
   "peerDependencies": {
+    "@azure-tools/typespec-client-generator-core": "workspace:^",
     "@typespec/compiler": "workspace:^"
   },
   "devDependencies": {
+    "@azure-tools/typespec-client-generator-core": "workspace:^",
     "@types/node": "catalog:",
     "@typespec/compiler": "workspace:^",
     "@vitest/coverage-v8": "catalog:",

packages/typespec-metadata/src/collector.ts

@@ -321,6 +321,7 @@ export interface LanguageCollectionResult {
 export async function collectLanguagePackages(
   program: Program,
   baseOutputDir: string,
+  resolvedApiVersion?: string,
 ): Promise<LanguageCollectionResult> {
   const optionMap = program.compilerOptions.options ?? {};
   const params = extractParameters(optionMap);
@@ -336,7 +337,7 @@ export async function collectLanguagePackages(
   }
 
   return {
-    languages: buildLanguageMetadata(optionMap, params, baseOutputDir, defaultServiceDir),
+    languages: buildLanguageMetadata(optionMap, params, baseOutputDir, defaultServiceDir, resolvedApiVersion),
     sourceConfigPath: program.compilerOptions.config,
   };
 }
@@ -483,6 +484,7 @@ export function buildLanguageMetadata(
   params: Record<string, unknown>,
   baseOutputDir: string,
   defaultServiceDir?: string,
+  resolvedApiVersion?: string,
 ): Record<string, LanguagePackageMetadata[]> {
   const languagesDict: Record<string, LanguagePackageMetadata[]> = {};
 
@@ -493,6 +495,7 @@ export function buildLanguageMetadata(
       params,
       baseOutputDir,
       defaultServiceDir,
+      resolvedApiVersion,
     );
     const language = inferLanguageFromEmitterName(emitterName);
     if (!languagesDict[language]) {
@@ -510,6 +513,7 @@ function createLanguageMetadata(
   params: Record<string, unknown>,
   baseOutputDir: string,
   defaultServiceDir?: string,
+  resolvedApiVersion?: string,
 ): LanguagePackageMetadata {
   const normalizedOptions = normalizeOptionsObject(emitterOptions);
 
@@ -585,6 +589,7 @@ function createLanguageMetadata(
     outputDir: relativeOutputDir,
     flavor: flavor ? String(flavor) : undefined,
     serviceDir,
+    apiVersion: resolvedApiVersion,
   };
 }
 

packages/typespec-metadata/src/emitter.ts

@@ -1,4 +1,5 @@
 import { emitFile, getDirectoryPath, resolvePath, type EmitContext } from "@typespec/compiler";
+import { createSdkContext } from "@azure-tools/typespec-client-generator-core";
 import { stringify as stringifyYaml } from "yaml";
 import packageJson from "../package.json" with { type: "json" };
 import { buildSpecMetadata, collectLanguagePackages } from "./collector.js";
@@ -18,7 +19,23 @@ export async function $onEmit(context: EmitContext<MetadataEmitterOptions>): Pro
   // Get the common tsp-output directory (parent of this emitter's output dir)
   const commonOutputDir = getDirectoryPath(getDirectoryPath(context.emitterOutputDir));
 
-  const languageResult = await collectLanguagePackages(context.program, commonOutputDir);
+  // Resolve API version using TCGC
+  const sdkContext = await createSdkContext(context as any);
+  const apiVersionsMap = sdkContext.sdkPackage.metadata.apiVersions;
+  let resolvedApiVersion: string | undefined;
+  if (apiVersionsMap && apiVersionsMap.size > 0) {
+    if (apiVersionsMap.size > 1) {
+      resolvedApiVersion = "multiple-versions";
+    } else {
+      resolvedApiVersion = [...apiVersionsMap.values()][0];
+    }
+  }
+
+  const languageResult = await collectLanguagePackages(
+    context.program,
+    commonOutputDir,
+    resolvedApiVersion,
+  );
 
   const snapshot: MetadataSnapshot = {
     emitterVersion: SNAPSHOT_VERSION,

packages/typespec-metadata/src/metadata.ts

@@ -20,6 +20,14 @@ export interface LanguagePackageMetadata {
   flavor?: string;
   /** Service directory path for this language emitter. */
   serviceDir?: string;
+  /**
+   * Resolved API version for this emitter.
+   * - `"all"` when configured for all versions
+   * - `"multiple-versions"` for multi-service configs with more than one API version entry
+   * - An actual resolved version string (e.g. `"2023-10-01"`) for a single version
+   * - `undefined` when no API version information is available
+   */
+  apiVersion?: string;
 }
 
 export interface MetadataSnapshot {

packages/typespec-metadata/test/collector.test.ts

@@ -681,3 +681,91 @@ describe("multiple emitters per language", () => {
     expect(result["unknown"][1].emitterName).toBe("@typespec/json-schema");
   });
 });
+
+describe("apiVersion extraction", () => {
+  it("passes through 'all' as the resolved apiVersion", () => {
+    const optionMap = {
+      "@azure-tools/typespec-python": {
+        "package-name": "azure-keyvault-secrets",
+      },
+    };
+
+    const result = buildLanguageMetadata(optionMap, {}, "/base/tsp-output", undefined, "all");
+
+    expect(result["python"][0].apiVersion).toBe("all");
+  });
+
+  it("passes through an actual resolved version string", () => {
+    const optionMap = {
+      "@azure-tools/typespec-python": {
+        "package-name": "azure-keyvault-secrets",
+      },
+    };
+
+    const result = buildLanguageMetadata(
+      optionMap,
+      {},
+      "/base/tsp-output",
+      undefined,
+      "2023-10-01",
+    );
+
+    expect(result["python"][0].apiVersion).toBe("2023-10-01");
+  });
+
+  it("passes through 'multiple-versions' for multi-service configs", () => {
+    const optionMap = {
+      "@azure-tools/typespec-python": {
+        "package-name": "azure-keyvault-secrets",
+      },
+    };
+
+    const result = buildLanguageMetadata(
+      optionMap,
+      {},
+      "/base/tsp-output",
+      undefined,
+      "multiple-versions",
+    );
+
+    expect(result["python"][0].apiVersion).toBe("multiple-versions");
+  });
+
+  it("leaves apiVersion undefined when no resolved version is provided", () => {
+    const optionMap = {
+      "@azure-tools/typespec-python": {
+        "package-name": "azure-keyvault-secrets",
+      },
+    };
+
+    const result = buildLanguageMetadata(optionMap, {}, "/base/tsp-output");
+
+    expect(result["python"][0].apiVersion).toBeUndefined();
+  });
+
+  it("applies the same resolved apiVersion to all emitters", () => {
+    const optionMap = {
+      "@azure-tools/typespec-python": {
+        "package-name": "azure-keyvault-secrets",
+      },
+      "@azure-tools/typespec-java": {
+        "package-name": "com.azure:azure-keyvault-secrets",
+      },
+      "@azure-tools/typespec-csharp": {
+        "package-name": "Azure.Security.KeyVault.Secrets",
+      },
+    };
+
+    const result = buildLanguageMetadata(
+      optionMap,
+      {},
+      "/base/tsp-output",
+      undefined,
+      "2023-10-01",
+    );
+
+    expect(result["python"][0].apiVersion).toBe("2023-10-01");
+    expect(result["java"][0].apiVersion).toBe("2023-10-01");
+    expect(result["csharp"][0].apiVersion).toBe("2023-10-01");
+  });
+});