fix(typescript): use string values for enum snippets (#4617)

generators/typescript/model/type-generator/src/AbstractGeneratedType.ts

@@ -60,7 +60,10 @@ export abstract class AbstractGeneratedType<Shape, Context> implements BaseGener
         }
         for (const example of this.examples) {
             const exampleStr =
-                "@example\n" + getTextOfTsNode(this.buildExample(example.shape, context, { isForComment: true }));
+                "@example\n" +
+                getTextOfTsNode(
+                    this.buildExample(example.shape, context, { isForComment: true, isForTypeDeclarationComment: true })
+                );
             groups.push(exampleStr.replaceAll("\n", `\n${EXAMPLE_PREFIX}`));
         }
         if (groups.length === 0) {

generators/typescript/model/type-generator/src/enum/GeneratedEnumTypeImpl.ts

@@ -229,10 +229,14 @@ export class GeneratedEnumTypeImpl<Context extends BaseContext>
         if (enumValue == null) {
             throw new Error("No enum with wire value: " + example.value.wireValue);
         }
-        return ts.factory.createPropertyAccessExpression(
-            this.getReferenceToSelf(context).getExpression(opts),
-            this.getEnumValueName(enumValue)
-        );
+        if (opts.isForTypeDeclarationComment) {
+            return ts.factory.createPropertyAccessExpression(
+                this.getReferenceToSelf(context).getExpression(opts),
+                this.getEnumValueName(enumValue)
+            );
+        } else {
+            return ts.factory.createStringLiteral(example.value.wireValue);
+        }
     }
 
     private getEnumValueName(enumValue: EnumValue): string {

generators/typescript/sdk/CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.39.8] - 2024-08-27
+
+- Fix: The generated enum examples now reference the value of the enum directly instead 
+  of using the enum itself. 
+
+  ### Before
+
+  ```ts
+  {
+    "genre": Imdb.Genre.Humor,
+  }
+  ```
+
+  ### After
+
+  ```ts
+  {
+    "genre": "humor"
+  }
+  ```
+
+
 ## [0.39.7] - 2024-08-27
 
 - Chore: The SDK now produces a `version.ts` file where we export a constant called `SDK_VERSION`. 

generators/typescript/sdk/VERSION

@@ -1 +1 @@
-0.39.7
+0.39.8

generators/typescript/utils/commons/src/referencing/Reference.ts

@@ -7,6 +7,7 @@ export interface Reference {
 }
 
 export interface GetReferenceOpts {
+    isForTypeDeclarationComment?: boolean;
     isForComment?: boolean;
     isForSnippet?: boolean;
 }