[dev-tool] Fix samples-dev cross-imports under Node strip-types -- from copilot

common/tools/dev-tool/src/util/samples/generation.ts

@@ -326,6 +326,31 @@ function jsonify(value: unknown) {
   return output;
 }
 
+/**
+ * Rewrites relative `.ts` import/export specifiers in TypeScript sample source
+ * text to use `.js` extensions.
+ *
+ * Samples authored under `samples-dev/` use `.ts` extensions on relative imports
+ * so that Node's native TypeScript loader can resolve sibling sample files when
+ * developers run them directly. Published TypeScript samples, however, are
+ * compiled with `tsc` into `dist/` and must reference the emitted `.js` files
+ * to be runnable. This helper performs that rewrite on the copied sample text.
+ *
+ * Matches the following forms:
+ * - `import ... from "./foo.ts"`
+ * - `import "./foo.ts"`
+ * - `import("./foo.ts")` (dynamic import)
+ * - `export ... from "./foo.ts"`
+ *
+ * @param content - the raw module source text
+ */
+function rewriteRelativeTsImports(content: string): string {
+  return content.replace(
+    /(\b(?:import|export|from)\s*\(?\s*)(['"])(\.\.?\/[^'"]*?)\.ts(['"])/g,
+    "$1$2$3.js$4",
+  );
+}
+
 /**
  * Checks if a file exists.
  * @param filePath - The path to the file
@@ -368,6 +393,7 @@ export async function createTsconfig(projectInfo: ProjectInfo): Promise<string>
   delete tsconfig.compilerOptions.inlineSources;
   delete tsconfig.compilerOptions.sourceMap;
   delete tsconfig.compilerOptions.verbatimModuleSyntax;
+  delete tsconfig.compilerOptions.allowImportingTsExtensions;
   tsconfig.include = ["./src"];
   tsconfig.compilerOptions.outDir = "./dist";
   tsconfig.compilerOptions.rootDir = "./src";
@@ -429,7 +455,7 @@ export async function makeSamplesFactory(
   function postProcess(moduleText: string | Buffer): string {
     const content = Buffer.isBuffer(moduleText) ? moduleText.toString("utf8") : moduleText;
     return (
-      content
+      rewriteRelativeTsImports(content)
         .replace(new RegExp(`^\\s*\\*\\s*@${AZSDK_META_TAG_PREFIX}.*\n`, "gm"), "")
         // We also need to clean up extra blank lines that might be left behind by
         // removing azsdk tags. These regular expressions are extremely frustrating

common/tools/dev-tool/src/util/samples/processor.ts

@@ -159,6 +159,7 @@ export async function processSources(
         result.summary === undefined &&
         !importedRelativeModules.has(result.relativeSourcePath.replace(/\.ts$/, "")) &&
         !importedRelativeModules.has(result.relativeSourcePath.replace(/\.ts$/, ".js")) &&
+        !importedRelativeModules.has(result.relativeSourcePath) &&
         !result.azSdkTags.util
       ) {
         fail(

common/tools/dev-tool/src/util/samples/transforms.ts

@@ -90,7 +90,11 @@ export function importDeclarationToCommonJs(
     factory.createCallExpression(
       factory.createIdentifier("require"),
       /* typeArguments: */ undefined,
-      [factory.createStringLiteral((decl.moduleSpecifier as ts.StringLiteral).text)],
+      [
+        factory.createStringLiteral(
+          convertTsExtensionToJs((decl.moduleSpecifier as ts.StringLiteral).text),
+        ),
+      ],
     );
 
   if (!decl.importClause) {
@@ -241,6 +245,27 @@ export function isNodeBuiltin(moduleSpecifier: string): boolean {
  */
 export const isRelativePath = (input: string): boolean => /^\.\.?[/\\]/.test(input);
 
+/**
+ * Rewrites a relative module specifier ending in `.ts` to use `.js` instead.
+ *
+ * Sample sources under `samples-dev/` use `.ts` extensions on relative imports
+ * so that Node's native TypeScript loader can resolve sibling sample files
+ * directly. When publishing the camera-ready samples, both the TypeScript and
+ * JavaScript outputs are emitted as `.js`, so the import specifiers must be
+ * rewritten to match.
+ *
+ * Non-relative specifiers (package imports, node builtins) and specifiers that
+ * are not `.ts` are returned unchanged. `.d.ts` specifiers are also left alone.
+ *
+ * @param specifier - the module specifier to normalize
+ */
+export function convertTsExtensionToJs(specifier: string): string {
+  if (isRelativePath(specifier) && specifier.endsWith(".ts") && !specifier.endsWith(".d.ts")) {
+    return specifier.slice(0, -".ts".length) + ".js";
+  }
+  return specifier;
+}
+
 /**
  * Determines whether a module specifier is a package dependency.
  *

sdk/ai/ai-projects/samples-dev/agents/tools/agentComputerUse.ts

@@ -25,7 +25,7 @@ import {
   loadScreenshotAssets,
   handleComputerActionAndTakeScreenshot,
   printFinalOutput,
-} from "./computerUseUtil.js";
+} from "./computerUseUtil.ts";
 
 const projectEndpoint = process.env["FOUNDRY_PROJECT_ENDPOINT"] || "<project endpoint>";
 const deploymentName =

sdk/appconfiguration/app-configuration/samples-dev/updateSyncTokenSample.ts

@@ -13,7 +13,7 @@
 import { AppConfigurationClient } from "@azure/app-configuration";
 import type { EventGridEvent } from "@azure/eventgrid";
 import { isSystemEvent, EventGridDeserializer } from "@azure/eventgrid";
-import { appConfigTestEvent } from "./testData.js";
+import { appConfigTestEvent } from "./testData.ts";
 
 // Load the .env file if it exists
 import * as dotenv from "dotenv";

sdk/attestation/attestation/samples-dev/attestEnclaves.ts

@@ -25,8 +25,8 @@
  */
 import { AttestationClient } from "@azure/attestation";
 import { DefaultAzureCredential } from "@azure/identity";
-import { writeBanner } from "./utils/helpers.js";
-import { decodeString } from "./utils/base64url.js";
+import { writeBanner } from "./utils/helpers.ts";
+import { decodeString } from "./utils/base64url.ts";
 // Load environment from a .env file if it exists.
 import "dotenv/config";
 

sdk/attestation/attestation/samples-dev/createAttestationClient.ts

@@ -25,7 +25,7 @@
 import { AttestationClient } from "@azure/attestation";
 import { DefaultAzureCredential } from "@azure/identity";
 import { X509 } from "jsrsasign";
-import { writeBanner } from "./utils/helpers.js";
+import { writeBanner } from "./utils/helpers.ts";
 // Load environment from a .env file if it exists.
 import "dotenv/config";
 

sdk/attestation/attestation/samples-dev/getAttestationPolicy.ts

@@ -26,7 +26,7 @@
 
 import { AttestationAdministrationClient, KnownAttestationType } from "@azure/attestation";
 import { DefaultAzureCredential } from "@azure/identity";
-import { writeBanner } from "./utils/helpers.js";
+import { writeBanner } from "./utils/helpers.ts";
 // Load environment from a .env file if it exists.
 import "dotenv/config";
 

sdk/attestation/attestation/samples-dev/getPolicyManagementCertificates.ts

@@ -27,7 +27,7 @@
 import { AttestationAdministrationClient } from "@azure/attestation";
 import { DefaultAzureCredential } from "@azure/identity";
 import { X509 } from "jsrsasign";
-import { writeBanner } from "./utils/helpers.js";
+import { writeBanner } from "./utils/helpers.ts";
 // Load environment from a .env file if it exists.
 import "dotenv/config";
 

sdk/attestation/attestation/samples-dev/modifyPolicyManagementCertificates.ts

@@ -31,9 +31,9 @@
 
 import { AttestationAdministrationClient } from "@azure/attestation";
 import { DefaultAzureCredential } from "@azure/identity";
-import { createRSAKey, createX509Certificate, generateSha1Hash } from "./utils/cryptoUtils.js";
+import { createRSAKey, createX509Certificate, generateSha1Hash } from "./utils/cryptoUtils.ts";
 import { X509 } from "jsrsasign";
-import { writeBanner } from "./utils/helpers.js";
+import { writeBanner } from "./utils/helpers.ts";
 // Load environment from a .env file if it exists.
 import "dotenv/config";
 

sdk/attestation/attestation/samples-dev/setAttestationPolicy.ts

@@ -36,8 +36,8 @@ import {
   KnownAttestationType,
 } from "@azure/attestation";
 import { DefaultAzureCredential } from "@azure/identity";
-import { writeBanner } from "./utils/helpers.js";
-import { createRSAKey, createX509Certificate, generateSha256Hash } from "./utils/cryptoUtils.js";
+import { writeBanner } from "./utils/helpers.ts";
+import { createRSAKey, createX509Certificate, generateSha256Hash } from "./utils/cryptoUtils.ts";
 import { X509 } from "jsrsasign";
 // Load environment from a .env file if it exists.
 import "dotenv/config";

sdk/cosmosdb/cosmos/samples-dev/AlterQueryThroughput.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { finish, handleError, logStep, logSampleHeader } from "./Shared/handleError.js";
+import { finish, handleError, logStep, logSampleHeader } from "./Shared/handleError.ts";
 import type {
   OfferDefinition,
   Resource,

sdk/cosmosdb/cosmos/samples-dev/Bulk.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { handleError, finish, logStep } from "./Shared/handleError.js";
+import { handleError, finish, logStep } from "./Shared/handleError.ts";
 import type { OperationInput } from "@azure/cosmos";
 import { BulkOperationType, CosmosClient, PatchOperationType } from "@azure/cosmos";
 

sdk/cosmosdb/cosmos/samples-dev/BulkUpdateWithSproc.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { logSampleHeader, handleError, finish, logStep } from "./Shared/handleError.js";
+import { logSampleHeader, handleError, finish, logStep } from "./Shared/handleError.ts";
 import { CosmosClient } from "@azure/cosmos";
 import { randomUUID } from "@azure/core-util";
 

sdk/cosmosdb/cosmos/samples-dev/ChangeFeed.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { finish, handleError, logSampleHeader } from "./Shared/handleError.js";
+import { finish, handleError, logSampleHeader } from "./Shared/handleError.ts";
 import { CosmosClient } from "@azure/cosmos";
 
 const key = process.env.COSMOS_KEY || "<cosmos key>";

sdk/cosmosdb/cosmos/samples-dev/ChangeFeedIterator/ChangeFeedHierarchicalPartitionKey.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { finish, handleError, logSampleHeader } from "../Shared/handleError.js";
+import { finish, handleError, logSampleHeader } from "../Shared/handleError.ts";
 import type { Container, ChangeFeedIteratorOptions } from "@azure/cosmos";
 import {
   CosmosClient,

sdk/cosmosdb/cosmos/samples-dev/ChangeFeedIterator/ChangeFeedIteratorAllVersionsAndDeletes.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { finish, handleError, logSampleHeader, logStep } from "../Shared/handleError.js";
+import { finish, handleError, logSampleHeader, logStep } from "../Shared/handleError.ts";
 import type {
   Container,
   ChangeFeedIteratorOptions,

sdk/cosmosdb/cosmos/samples-dev/ChangeFeedIterator/ChangeFeedIteratorLatestVersion.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { finish, handleError, logSampleHeader, logStep } from "../Shared/handleError.js";
+import { finish, handleError, logSampleHeader, logStep } from "../Shared/handleError.ts";
 import type {
   Container,
   ChangeFeedIteratorOptions,

sdk/cosmosdb/cosmos/samples-dev/ClientSideEncryption.ts

@@ -21,7 +21,7 @@ import {
   EncryptionType,
   EncryptionQueryBuilder,
 } from "@azure/cosmos";
-import { finish, handleError, logStep } from "./Shared/handleError.js";
+import { finish, handleError, logStep } from "./Shared/handleError.ts";
 
 const key = process.env.COSMOS_KEY || "<cosmos key>";
 const endpoint = process.env.COSMOS_ENDPOINT || "<cosmos endpoint>";

sdk/cosmosdb/cosmos/samples-dev/ContainerManagement.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { finish, handleError, logStep, logSampleHeader } from "./Shared/handleError.js";
+import { finish, handleError, logStep, logSampleHeader } from "./Shared/handleError.ts";
 import type { ContainerDefinition, IndexingPolicy, SpatialIndex } from "@azure/cosmos";
 import {
   CosmosClient,

sdk/cosmosdb/cosmos/samples-dev/DatabaseManagement.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { handleError, logStep, logSampleHeader, finish } from "./Shared/handleError.js";
+import { handleError, logStep, logSampleHeader, finish } from "./Shared/handleError.ts";
 import { CosmosClient } from "@azure/cosmos";
 import assert from "node:assert";
 

sdk/cosmosdb/cosmos/samples-dev/Diagnostics.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { handleError, logSampleHeader, finish } from "./Shared/handleError.js";
+import { handleError, logSampleHeader, finish } from "./Shared/handleError.ts";
 import type { OperationInput, Container, GatewayStatistics, Database } from "@azure/cosmos";
 import { CosmosClient, BulkOperationType, PatchOperationType } from "@azure/cosmos";
 

sdk/cosmosdb/cosmos/samples-dev/EntraAuth.ts

@@ -10,7 +10,7 @@ import { DefaultAzureCredential } from "@azure/identity";
 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
 // @ts-ignore
 import { CosmosClient } from "@azure/cosmos";
-import { handleError, finish, logStep } from "./Shared/handleError.js";
+import { handleError, finish, logStep } from "./Shared/handleError.ts";
 
 const key = process.env.COSMOS_KEY || "<cosmos key>";
 const endpoint = process.env.COSMOS_ENDPOINT || "<cosmos endpoint>";

sdk/cosmosdb/cosmos/samples-dev/ExcludedLocations.ts

@@ -8,7 +8,7 @@
 import "dotenv/config";
 import type { ChangeFeedIteratorOptions } from "@azure/cosmos";
 import { CosmosClient, BulkOperationType, ChangeFeedStartFrom } from "@azure/cosmos";
-import { handleError, logStep } from "./Shared/handleError.js";
+import { handleError, logStep } from "./Shared/handleError.ts";
 
 const endpoint = process.env.COSMOS_ENDPOINT || "<cosmos endpoint>";
 const key = process.env.COSMOS_KEY || "<cosmos key>";

sdk/cosmosdb/cosmos/samples-dev/ExecuteBulkOperations.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { handleError, finish, logStep } from "./Shared/handleError.js";
+import { handleError, finish, logStep } from "./Shared/handleError.ts";
 import type { OperationInput } from "@azure/cosmos";
 import { BulkOperationType, CosmosClient, PatchOperationType } from "@azure/cosmos";
 import { DefaultAzureCredential } from "@azure/identity";

sdk/cosmosdb/cosmos/samples-dev/HierarchicalPartitioning.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { handleError, logSampleHeader, finish } from "./Shared/handleError.js";
+import { handleError, logSampleHeader, finish } from "./Shared/handleError.ts";
 import type { PatchOperation, OperationInput } from "@azure/cosmos";
 import {
   CosmosClient,

sdk/cosmosdb/cosmos/samples-dev/IndexManagement.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { logSampleHeader, handleError, finish, logStep } from "./Shared/handleError.js";
+import { logSampleHeader, handleError, finish, logStep } from "./Shared/handleError.ts";
 import type { ContainerDefinition } from "@azure/cosmos";
 import { CosmosClient, IndexKind, DataType, IndexingMode } from "@azure/cosmos";
 

sdk/cosmosdb/cosmos/samples-dev/ItemManagement.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { logSampleHeader, handleError, finish, logStep } from "./Shared/handleError.js";
+import { logSampleHeader, handleError, finish, logStep } from "./Shared/handleError.ts";
 import type { PatchOperation } from "@azure/cosmos";
 import { CosmosClient, PriorityLevel } from "@azure/cosmos";
 import FamiliesJSON from "./Data/Families.json" with { type: "json" };

sdk/cosmosdb/cosmos/samples-dev/PriorityLevel.ts

@@ -7,7 +7,7 @@
  */
 
 import "dotenv/config";
-import { finish, handleError, logSampleHeader, logStep } from "./Shared/handleError.js";
+import { finish, handleError, logSampleHeader, logStep } from "./Shared/handleError.ts";
 import type {
   Container,
   ChangeFeedIteratorOptions,

sdk/cosmosdb/cosmos/samples-dev/Query/FullTextSearch.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { finish, handleError, logSampleHeader } from "./../Shared/handleError.js";
+import { finish, handleError, logSampleHeader } from "./../Shared/handleError.ts";
 import type { IndexingPolicy } from "@azure/cosmos";
 import { CosmosClient } from "@azure/cosmos";
 

sdk/cosmosdb/cosmos/samples-dev/SasTokenAuth.ts

@@ -8,7 +8,7 @@
 import "dotenv/config";
 import type { SasTokenProperties } from "@azure/cosmos";
 import { CosmosClient, createAuthorizationSasToken, SasTokenPermissionKind } from "@azure/cosmos";
-import { handleError, finish, logStep } from "./Shared/handleError.js";
+import { handleError, finish, logStep } from "./Shared/handleError.ts";
 const masterKey = process.env.COSMOS_KEY || "<cosmos key>";
 const endpoint = process.env.COSMOS_ENDPOINT || "<cosmos endpoint>";
 const sasToken = "your-sas-token";

sdk/cosmosdb/cosmos/samples-dev/ServerSideScripts.ts

@@ -6,7 +6,7 @@
  */
 
 import "dotenv/config";
-import { logSampleHeader, logStep, finish, handleError } from "./Shared/handleError.js";
+import { logSampleHeader, logStep, finish, handleError } from "./Shared/handleError.ts";
 import type { ErrorResponse, FeedOptions, Item, Resource } from "@azure/cosmos";
 import { CosmosClient } from "@azure/cosmos";
 

sdk/cosmosdb/cosmos/samples-dev/ThroughputBucket.ts

@@ -6,7 +6,7 @@
  */
 import "dotenv/config";
 import { ChangeFeedStartFrom, CosmosClient, type Container } from "@azure/cosmos";
-import { logSampleHeader, handleError, logStep } from "./Shared/handleError.js";
+import { logSampleHeader, handleError, logStep } from "./Shared/handleError.ts";
 import { randomUUID } from "@azure/core-util";
 
 const endpoint = process.env.COSMOS_ENDPOINT || "<cosmos endpoint>";

sdk/eventhub/eventhubs-checkpointstore-blob/samples-dev/receiveEventsWithApiSpecificStorage.ts

@@ -16,7 +16,7 @@ import { DefaultAzureCredential } from "@azure/identity";
 import { EventHubConsumerClient } from "@azure/event-hubs";
 import { BlobCheckpointStore } from "@azure/eventhubs-checkpointstore-blob";
 import { BlobServiceClient } from "@azure/storage-blob";
-import { createCustomPipeline } from "./createCustomPipeline.js";
+import { createCustomPipeline } from "./createCustomPipeline.ts";
 
 import "dotenv/config";
 

sdk/formrecognizer/ai-form-recognizer/samples-dev/analyzeBusinessCard.ts

@@ -16,7 +16,7 @@
 
 import { DocumentAnalysisClient } from "@azure/ai-form-recognizer";
 import { DefaultAzureCredential } from "@azure/identity";
-import { PrebuiltBusinessCardModel } from "./prebuilt/prebuilt-businessCard.js";
+import { PrebuiltBusinessCardModel } from "./prebuilt/prebuilt-businessCard.ts";
 import "dotenv/config";
 
 async function main(): Promise<void> {