microsoft · JennyPng · Mar 27, 2026 · Mar 30, 2026 · Mar 30, 2026 · Mar 30, 2026
diff --git a/.chronus/changes/playground-upload-python-2026-3-1-16-58-54.md b/.chronus/changes/playground-upload-python-2026-3-1-16-58-54.md
@@ -0,0 +1,9 @@
+---
+changeKind: internal
+packages:
+  - "@typespec/http-client-python"
+  - "@typespec/bundle-uploader"
+  - "@typespec/playground-website"
+---
+
+Extend publish pipeline to upload emitter bundles to Playground storage account. Update Python emitter to be browser-compatible for use in the TypeSpec playground.
@@ -0,0 +1,16 @@
+name: Build playground emitters
+description: Build emitter packages required by the playground (excluded from pnpm workspace)
+
+runs:
+  using: composite
+
+  steps:
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.x"
+
+    - name: Build http-client-python emitter
+      shell: bash
+      working-directory: packages/http-client-python
+      run: npm ci && npm run build
@@ -39,6 +39,8 @@ jobs:
       - name: Install dependencies
         run: pnpm install
 
+      - uses: ./.github/actions/build-playground-emitters
+
       - name: Restore .NET dependencies
         run: dotnet restore
         working-directory: packages/typespec-vs
@@ -72,6 +74,8 @@ jobs:
       - name: Install dependencies
         run: pnpm install
 
+      - uses: ./.github/actions/build-playground-emitters
+
       - name: Install Playwright browsers
         run: npx playwright install --with-deps
 
@@ -98,6 +102,8 @@ jobs:
       - name: Install dependencies
         run: pnpm install
 
+      - uses: ./.github/actions/build-playground-emitters
+
       - name: Install Playwright browsers
         run: |
           sudo dpkg --configure -a

@@ -61,6 +61,9 @@ jobs:
       - name: Install Playwright
         run: pnpm exec playwright install
 
+      - name: Build playground emitters
+        run: cd core/packages/http-client-python && npm ci && npm run build
+
       - name: Build
         run: pnpm build
 

@@ -82,6 +82,11 @@ parameters:
     type: string
     default: "3.12"
 
+  # Whether to bundle and upload the emitter package to the playground package storage.
+  - name: UploadPlaygroundBundle
+    type: boolean
+    default: false
+
 stages:
   # Build stage
   # Responsible for building the autorest generator and typespec emitter packages
@@ -333,6 +338,29 @@ stages:
                   ArtifactPath: $(buildArtifactsPath)
                   LanguageShortName: ${{ parameters.LanguageShortName }}
 
+              - ${{ if parameters.UploadPlaygroundBundle }}:
+                  - script: npm ci
+                    displayName: Install emitter dependencies for playground bundle
+                    workingDirectory: $(Build.SourcesDirectory)/${{ parameters.PackagePath }}
+                  - script: npm run build
+                    displayName: Build emitter for playground bundle
+                    workingDirectory: $(Build.SourcesDirectory)/${{ parameters.PackagePath }}
+                  - script: npm install -g pnpm
+                    displayName: Install pnpm for playground bundle upload
+                  - script: pnpm install --filter "@typespec/bundle-uploader..."
+                    displayName: Install bundle-uploader dependencies
+                    workingDirectory: $(Build.SourcesDirectory)
+                  - script: pnpm --filter "@typespec/bundle-uploader..." build
+                    displayName: Build bundle-uploader
+                    workingDirectory: $(Build.SourcesDirectory)
+                  - task: AzureCLI@1
+                    displayName: Upload playground bundle
+                    inputs:
+                      azureSubscription: "Azure SDK Engineering System"
+                      scriptLocation: inlineScript
+                      inlineScript: node ./eng/emitters/scripts/upload-bundled-emitter.js ${{ parameters.PackagePath }}
+                      workingDirectory: $(Build.SourcesDirectory)
+
             templateContext:
               outputs:
                 - output: pipelineArtifact

@@ -0,0 +1,18 @@
+// @ts-check
+import { resolve } from "path";
+import { bundleAndUploadStandalonePackage } from "../../../packages/bundle-uploader/dist/src/index.js";
+import { repoRoot } from "../../common/scripts/helpers.js";
+
+const packageRelativePath = process.argv[2];
+if (!packageRelativePath) {
+  // eslint-disable-next-line no-console
+  console.error("Usage: node upload-bundled-emitter.js <package-path>");
+  // eslint-disable-next-line no-console
+  console.error("  e.g. node upload-bundled-emitter.js packages/http-client-csharp");
+  process.exit(1);
+}
+
+// remove leading slash if exists, then resolve to absolute path
+const packagePath = resolve(repoRoot, packageRelativePath.replace(/^\//, ""));
+
+await bundleAndUploadStandalonePackage({ packagePath });
@@ -10,6 +10,8 @@ steps:
       nodeVersion: ${{ parameters.nodeVersion }}
       useDotnet: true
 
+  - template: /eng/tsp-core/pipelines/templates/build-playground-emitters.yml
+
   - template: /eng/tsp-core/pipelines/templates/build.yml
 
   - script: pnpm run test:ci

@@ -18,6 +18,7 @@ jobs:
 
     steps:
       - template: /eng/tsp-core/pipelines/templates/install.yml
+      - template: /eng/tsp-core/pipelines/templates/build-playground-emitters.yml
       - template: /eng/tsp-core/pipelines/templates/install-browsers.yml
       - template: /eng/tsp-core/pipelines/templates/setup-linux-ui.yml
       - template: /eng/tsp-core/pipelines/templates/build.yml

@@ -1,5 +1,6 @@
 steps:
   - template: /eng/tsp-core/pipelines/templates/install.yml
+  - template: /eng/tsp-core/pipelines/templates/build-playground-emitters.yml
 
   - script: pnpm exec playwright install
     displayName: Install browsers

@@ -35,6 +35,7 @@ extends:
               - template: /eng/tsp-core/pipelines/templates/install.yml
               - template: /eng/tsp-core/pipelines/templates/install-browsers.yml
 
+              - template: /eng/tsp-core/pipelines/templates/build-playground-emitters.yml
               - template: /eng/tsp-core/pipelines/templates/build.yml
 
               - task: AzureCLI@1

@@ -0,0 +1,9 @@
+# Build emitter packages required by the playground (excluded from pnpm workspace)
+steps:
+  - task: UsePythonVersion@0
+    displayName: Set up Python
+    inputs:
+      versionSpec: "3.x"
+
+  - script: cd packages/http-client-python && npm ci && npm run build
+    displayName: Build http-client-python emitter
@@ -41,6 +41,7 @@
     "@azure/storage-blob": "catalog:",
     "@pnpm/workspace.find-packages": "catalog:",
     "@typespec/bundler": "workspace:^",
+    "globby": "catalog:",
     "json5": "catalog:",
     "picocolors": "catalog:",
     "semver": "catalog:"

@@ -1,7 +1,9 @@
 import { AzureCliCredential } from "@azure/identity";
 import { findWorkspacePackagesNoCheck } from "@pnpm/workspace.find-packages";
 import { createTypeSpecBundle } from "@typespec/bundler";
-import { resolve } from "path";
+import { readFile } from "fs/promises";
+import { globby } from "globby";
+import { relative, resolve } from "path";
 import { join as joinUnix } from "path/posix";
 import pc from "picocolors";
 import { parse } from "semver";
@@ -16,6 +18,137 @@ function logSuccess(message: string) {
   logInfo(pc.green(`✔ ${message}`));
 }
 
+export interface PlaygroundAssetConfig {
+  /** Glob pattern relative to the package root (e.g. "generator/dist/pygen-*.whl"). */
+  path: string;
+  /** MIME content type for the blob upload. */
+  contentType: string;
+}
+
+export interface PlaygroundConfig {
+  /** Static files to upload as binary blobs. Paths support simple glob patterns. */
+  assets?: PlaygroundAssetConfig[];
+  /** Peer dependencies that should be bundled and uploaded. */
+  bundlePeerDependencies?: string[];
+}
+
+export interface BundleAndUploadStandalonePackageOptions {
+  /**
+   * Absolute path to the package directory.
+   */
+  packagePath: string;
+}
+
+/**
+ * Bundle and upload a standalone package that is not part of the pnpm workspace.
+ * Uploads the bundle files and writes a `latest.json` under the package's blob directory
+ * (e.g. `@typespec/http-client-csharp/latest.json`).
+ *
+ * If the package's `package.json` contains a `playgroundConfig` section, this function
+ * will also upload static assets (resolved via glob patterns) and bundle peer dependencies.
+ */
+export async function bundleAndUploadStandalonePackage({
+  packagePath,
+}: BundleAndUploadStandalonePackageOptions) {
+  const pkgJsonPath = resolve(packagePath, "package.json");
+  const pkgJson = JSON.parse(await readFile(pkgJsonPath, "utf-8"));
+  const playgroundConfig: PlaygroundConfig | undefined = pkgJson.playgroundConfig;
+
+  const bundle = await createTypeSpecBundle(packagePath);
+  const manifest = bundle.manifest;
+  logInfo(`Bundling standalone package: ${manifest.name}@${manifest.version}`);
+
+  const uploader = new TypeSpecBundledPackageUploader(new AzureCliCredential());
+  await uploader.createIfNotExists();
+
+  const result = await uploader.upload(bundle);
+  if (result.status === "uploaded") {
+    logSuccess(`Bundle for package ${manifest.name}@${manifest.version} uploaded.`);
+  } else {
+    logInfo(`Bundle for package ${manifest.name} already exists for version ${manifest.version}.`);
+  }
+
+  const importMap: Record<string, string> = {};
+  for (const [key, value] of Object.entries(result.imports)) {
+    importMap[joinUnix(manifest.name, key)] = value;
+  }
+
+  await uploadPlaygroundAssets(uploader, packagePath, manifest, importMap, playgroundConfig);
+
+  await uploader.updatePackageLatest(manifest.name, {
+    version: manifest.version,
+    imports: importMap,
+  });
+  logSuccess(`Updated ${manifest.name}/latest.json for version ${manifest.version}.`);
+}
+
+/**
+ * Upload playground assets and bundle peer dependencies based on the provided config.
+ */
+async function uploadPlaygroundAssets(
+  uploader: TypeSpecBundledPackageUploader,
+  packagePath: string,
+  manifest: { name: string; version: string },
+  importMap: Record<string, string>,
+  config: PlaygroundConfig | undefined,
+) {
+  if (!config) {
+    return;
+  }
+
+  // Upload static assets (e.g. .whl files)
+  if (config.assets) {
+    for (const asset of config.assets) {
+      const matchedFiles = await globby(asset.path, { cwd: packagePath, absolute: true });
+      if (matchedFiles.length === 0) {
+        logInfo(pc.yellow(`⚠ No files matched asset pattern: ${asset.path}`));
+        continue;
+      }
+      for (const filePath of matchedFiles) {
+        const relativePath = relative(packagePath, filePath).replace(/\\/g, "/");
+        const blobPath = joinUnix(manifest.name, manifest.version, relativePath);
+        const content = await readFile(filePath);
+        const assetResult = await uploader.uploadBinaryAsset(blobPath, content, asset.contentType);
+        const importKey = joinUnix(manifest.name, relativePath);
+        importMap[importKey] = assetResult.url;
+        if (assetResult.status === "uploaded") {
+          logSuccess(`Uploaded asset: ${relativePath}`);
+        } else {
+          logInfo(`Asset already exists: ${relativePath}`);
+        }
+      }
+    }
+  }
+
+  // Bundle and upload peer dependencies
+  if (config.bundlePeerDependencies) {
+    for (const depName of config.bundlePeerDependencies) {
+      const depPath = resolve(packagePath, "node_modules", depName);
+      try {
+        const depBundle = await createTypeSpecBundle(depPath);
+        const depResult = await uploader.upload(depBundle);
+        if (depResult.status === "uploaded") {
+          logSuccess(
+            `Bundle for peer dep ${depBundle.manifest.name}@${depBundle.manifest.version} uploaded.`,
+          );
+        } else {
+          logInfo(
+            `Bundle for peer dep ${depBundle.manifest.name} already exists for version ${depBundle.manifest.version}.`,
+          );
+        }
+        for (const [key, value] of Object.entries(depResult.imports)) {
+          importMap[joinUnix(depBundle.manifest.name, key)] = value;
+        }
+      } catch (e: unknown) {
+        throw new Error(
+          `Failed to bundle peer dependency ${depName}: ${e instanceof Error ? e.message : e}`,
+          { cause: e },
+        );
+      }
+    }
+  }
+}
+
 export interface BundleAndUploadPackagesOptions {
   repoRoot: string;
   /**
@@ -85,9 +218,12 @@ export async function bundleAndUploadPackages({
     }
   }
   logInfo(`Import map for ${indexVersion}:`, importMap);
-  await uploader.updateIndex(indexName, {
+  const index = {
     version: indexVersion,
     imports: importMap,
-  });
+  };
+  await uploader.updateIndex(indexName, index);
   logSuccess(`Updated index for version ${indexVersion}.`);
+  await uploader.updateLatestIndex(indexName, index);
+  logSuccess(`Updated latest index for version ${indexVersion}.`);
 }