@azure-tools/typespec-ts 0.52.0 → 0.52.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-tools/typespec-ts",
-  "version": "0.52.0",
+  "version": "0.52.1",
   "description": "An experimental TypeSpec emitter for TypeScript RLC",
   "main": "dist/src/index.js",
   "type": "module",
@@ -18,15 +18,15 @@
   "license": "MIT",
   "devDependencies": {
     "@azure-rest/core-client": "^2.3.1",
-    "@typespec/http-specs": "0.1.0-dev.2",
-    "@typespec/spector": "0.1.0-dev.3",
-    "@typespec/spec-api": "0.1.0-alpha.14-dev.3",
+    "@typespec/http-specs": "0.1.0-alpha.36-dev.3",
+    "@typespec/spector": "0.1.0-alpha.25-dev.5",
+    "@typespec/spec-api": "0.1.0-alpha.14-dev.4",
     "@typespec/tspd": "0.74.1",
-    "@azure-tools/azure-http-specs": "0.1.0-alpha.39-dev.7",
-    "@azure-tools/typespec-autorest": "^0.66.1",
-    "@azure-tools/typespec-azure-core": "^0.66.1",
-    "@azure-tools/typespec-azure-resource-manager": "^0.66.1",
-    "@azure-tools/typespec-client-generator-core": "^0.66.4",
+    "@azure-tools/azure-http-specs": "0.1.0-alpha.40-dev.0",
+    "@azure-tools/typespec-autorest": "^0.67.0",
+    "@azure-tools/typespec-azure-core": "^0.67.0",
+    "@azure-tools/typespec-azure-resource-manager": "^0.67.0",
+    "@azure-tools/typespec-client-generator-core": "^0.67.1",
     "@azure/abort-controller": "^2.1.2",
     "@azure/core-auth": "^1.6.0",
     "@azure/core-lro": "^3.1.0",
@@ -39,12 +39,12 @@
     "@types/lodash": "^4.17.4",
     "@typescript-eslint/eslint-plugin": "^8.28.0",
     "@typescript-eslint/parser": "^8.28.0",
-    "@typespec/compiler": "^1.10.0",
-    "@typespec/http": "^1.10.0",
-    "@typespec/openapi": "^1.10.0",
-    "@typespec/rest": "^0.80.0",
+    "@typespec/compiler": "^1.11.0",
+    "@typespec/http": "^1.11.0",
+    "@typespec/openapi": "^1.11.0",
+    "@typespec/rest": "^0.81.0",
     "@typespec/ts-http-runtime": "^0.1.0",
-    "@typespec/versioning": "^0.80.0",
+    "@typespec/versioning": "^0.81.0",
     "chai": "^4.3.6",
     "chalk": "^4.0.0",
     "cross-env": "^7.0.3",
@@ -63,16 +63,16 @@
     "js-yaml": "^4.1.0"
   },
   "peerDependencies": {
-    "@azure-tools/typespec-azure-core": "^0.66.1",
-    "@azure-tools/typespec-client-generator-core": "^0.66.4",
-    "@typespec/compiler": "^1.10.0",
-    "@typespec/http": "^1.10.0",
-    "@typespec/rest": "^0.80.0",
-    "@typespec/versioning": "^0.80.0",
-    "@typespec/xml": "^0.80.0"
+    "@azure-tools/typespec-azure-core": "^0.67.0",
+    "@azure-tools/typespec-client-generator-core": "^0.67.1",
+    "@typespec/compiler": "^1.11.0",
+    "@typespec/http": "^1.11.0",
+    "@typespec/rest": "^0.81.0",
+    "@typespec/versioning": "^0.81.0",
+    "@typespec/xml": "^0.81.0"
   },
   "dependencies": {
-    "@azure-tools/rlc-common": "^0.52.0",
+    "@azure-tools/rlc-common": "^0.52.1",
     "fast-xml-parser": "^4.5.0",
     "fs-extra": "^11.1.0",
     "lodash": "^4.17.21",

package/src/lib.ts

@@ -86,6 +86,15 @@ export interface EmitterOptions {
    * Set to false to return the non-model types directly.
    */
   "wrap-non-model-return"?: boolean;
+  /**
+   * When set to true, HEAD operations with a void response body will return `{ body: boolean }`
+   * instead of `void`, where `body: true` indicates a 2xx success (resource exists) and
+   * `body: false` indicates a non-2xx response (e.g., 404 Not Found).
+   * This matches the HLC behavior for resource existence check operations.
+   * Only applies when `wrap-non-model-return` is also enabled.
+   * Defaults to `false`.
+   */
+  "head-as-boolean"?: boolean;
   /**
    * When enabled, every regular (non-LRO, non-paging) operation return type is augmented with a
    * `_response` property containing `rawResponse`, `parsedBody`, and `parsedHeaders`.
@@ -390,6 +399,12 @@ export const RLCOptionsSchema: JSONSchemaType<EmitterOptions> = {
       description:
         "When set to true (default for Azure services), non-model return types (arrays, scalars, enums, bytes with binary content type) will be wrapped in an XxxResponse type for HLC backward compatibility during TypeSpec migration."
     },
+    "head-as-boolean": {
+      type: "boolean",
+      nullable: true,
+      description:
+        "When set to true, HEAD operations with void response return `{ body: boolean }` (true=2xx, false=non-2xx) instead of void. Requires wrap-non-model-return to also be enabled. Defaults to false."
+    },
     "enable-storage-compat": {
       type: "boolean",
       nullable: true,

package/src/modular/helpers/operationHelpers.ts

@@ -233,6 +233,14 @@ export function getDeserializePrivateFunction(
       name: (response as any).name ?? "",
       type: getTypeExpression(context, response.type)
     };
+  } else if (
+    !response.type &&
+    isHeadOperation(operation) &&
+    context.rlcOptions?.headAsBoolean
+  ) {
+    // HEAD operation with head-as-boolean but wrap-non-model-return disabled:
+    // return plain boolean instead of wrapped { body: boolean }
+    returnType = { name: "", type: "boolean" };
   } else {
     returnType = { name: "", type: "void" };
   }
@@ -452,6 +460,18 @@ export function getDeserializePrivateFunction(
     }
   } else if (returnType.type === "void") {
     statements.push("return;");
+  } else if (
+    !deserializedType &&
+    isHeadOperation(operation) &&
+    context.rlcOptions?.headAsBoolean
+  ) {
+    if (shouldWrap) {
+      // Case 1: wrap-non-model-return + head-as-boolean → return { body: boolean }
+      statements.push(`return { body: result.status.startsWith("2") };`);
+    } else {
+      // Case 2: head-as-boolean only (no wrap) → return plain boolean
+      statements.push(`return result.status.startsWith("2");`);
+    }
   } else {
     statements.push("return;");
   }
@@ -1040,6 +1060,14 @@ export function getOperationFunction(
       name: "",
       type: `${buildHeaderOnlyResponseType(context, responseHeaders)}`
     };
+  } else if (
+    !response.type &&
+    isHeadOperation(operation) &&
+    context.rlcOptions?.headAsBoolean
+  ) {
+    // HEAD operation with head-as-boolean but wrap-non-model-return disabled:
+    // return plain boolean instead of wrapped { body: boolean }
+    returnType = { name: "", type: "boolean" };
   }
 
   // When storage-compat is enabled, wrap the return type with StorageCompatResponseInfo
@@ -3148,6 +3176,13 @@ function isWrappableType(context: SdkContext, type: SdkType): boolean {
   return true;
 }
 
+/**
+ * Returns true if the operation uses the HTTP HEAD method.
+ */
+function isHeadOperation(operation: ServiceOperation): boolean {
+  return operation.operation.verb.toLowerCase() === "head";
+}
+
 /**
  * Determines whether wrapping the non-model return type is needed for an operation.
  * Returns an object with `shouldWrap` (whether to wrap) and `isBinary` (whether it's a binary response).
@@ -3182,6 +3217,13 @@ export function checkWrapNonModelReturn(
 
   const { type } = operation.response;
   if (!type) {
+    // Special case: HEAD operation with void response → wrap as boolean { body: boolean }
+    // This matches HLC behavior where HEAD operations with no response body
+    // return { body: boolean } indicating if the resource exists (2xx = true, 4xx = false).
+    // Requires `head-as-boolean: true` to be explicitly set in the emitter options.
+    if (isHeadOperation(operation) && context.rlcOptions?.headAsBoolean) {
+      return { shouldWrap: true, isBinary: false };
+    }
     return noWrap; // void return type - no wrap needed
   }
 
@@ -3227,6 +3269,10 @@ export function buildNonModelResponseTypeDeclaration(
        */
       readableStreamBody?: NodeJS.ReadableStream;
   }`;
+  } else if (!operation.response.type && isHeadOperation(operation)) {
+    // HEAD as boolean: the body property is a boolean indicating if the resource exists.
+    // true = resource exists (2xx response), false = resource not found (e.g., 404)
+    typeBody = `{ body: boolean }`;
   } else {
     const returnType = getTypeExpression(context, operation.response.type!);
     typeBody = `{ body: ${returnType} }`;

package/src/transform/transfromRLCOptions.ts

@@ -95,6 +95,7 @@ function extractRLCOptions(
   const enableStorageCompat = emitterOptions["enable-storage-compat"] === true;
   const treatUnknownAsRecord =
     emitterOptions["treat-unknown-as-record"] === true;
+  const headAsBoolean = emitterOptions["head-as-boolean"] === true;
   const typespecTitleMap = emitterOptions["typespec-title-map"];
   const hasSubscriptionId = getSubscriptionId(dpgContext);
   const ignoreNullableOnOptional = getIgnoreNullableOnOptional(
@@ -141,7 +142,8 @@ function extractRLCOptions(
     wrapNonModelReturn,
     isMultiService,
     enableStorageCompat,
-    treatUnknownAsRecord
+    treatUnknownAsRecord,
+    headAsBoolean
   };
 }
 

package/src/utils/operationUtil.ts

@@ -670,6 +670,14 @@ export type ServiceOperation = SdkServiceMethod<SdkHttpOperation> & {
   oriName?: string;
 };
 
+export type ServiceParameter = (
+  | SdkMethodParameter
+  | SdkHttpParameter
+  | SdkBodyParameter
+) & {
+  oriName?: string;
+};
+
 export function getMethodHierarchiesMap(
   context: SdkContext,
   client: SdkClientType<SdkServiceOperation>
@@ -804,9 +812,23 @@ export function isTenantLevelOperation(
 
 function resolveParameterNameConflict(
   operationOrGroup: SdkServiceMethod<SdkHttpOperation>,
-  p: SdkMethodParameter | SdkHttpParameter | SdkBodyParameter
-): SdkMethodParameter | SdkHttpParameter | SdkBodyParameter {
-  const paramName = normalizeName(p.name, NameType.Parameter, true);
+  p: ServiceParameter
+): ServiceParameter {
+  // When the name starts with $DO_NOT_NORMALIZE$, record the original name so that
+  // subsequent calls (e.g. emitNonModelResponseTypes then buildApiOptions both call
+  // getMethodHierarchiesMap on the same TCGC object) always normalize from the
+  // original, not from the already-mutated value.
+  const paramName = normalizeName(
+    p.name,
+    NameType.Parameter,
+    true,
+    undefined,
+    undefined,
+    p.oriName
+  );
+  if (!p.oriName) {
+    p.oriName = p.name;
+  }
   if (paramName === operationOrGroup.name) {
     p.name = `${paramName}Parameter`;
   } else {