feat(typescript): export serializers under the namespace (#4649)

docker/seed/Dockerfile.ts

@@ -1,9 +1,4 @@
-FROM node:lts-slim as base
-
-FROM base AS builder
-
-RUN mkdir /yarn-cache-template
-RUN yarn config set cache-folder /yarn-cache-template
+FROM node:lts-slim
 
 RUN  yarn add \
   # jest
@@ -45,9 +40,6 @@ RUN  yarn add \
   # fetch mock jest
   fetch-mock-jest@1.5.1
 
-FROM base AS runner
-
-COPY --from=builder /yarn-cache-template /yarn-cache-template
 # Installs tsc
 RUN npm install -g typescript
 

generators/typescript/sdk/CHANGELOG.md

@@ -5,6 +5,25 @@ 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.40.3] - 2024-09-12
+
+- Fix: If the serde layer is enabled, then all the serializers are exported under the 
+  namespace `serializers`. 
+
+  ```ts
+  import { serializers } from "@plantstore/sdk"; 
+
+  export function main(): void { 
+    // serialize to json
+
+    const json = serializers.Plant.toJson({
+      name: "fern",
+    });
+
+    const parsed = serializers.Plant.parseOrThrow(`{ "name": "fern" }`);
+  }
+  ```
+
 ## [0.40.2] - 2024-09-12
 
 - Fix: The generated SDK now handles reading IR JSONs that are larger than 500MB. In order to 

generators/typescript/sdk/VERSION

@@ -1 +1 @@
-0.40.2
+0.40.3

generators/typescript/sdk/generator/src/SdkGenerator.ts

@@ -415,7 +415,13 @@ export class SdkGenerator {
             this.generateTypeSchemas();
             this.generateEndpointTypeSchemas();
             this.generateInlinedRequestBodySchemas();
-            this.context.logger.debug("Generated serde layer.");
+            const serializationDirectory = this.rootDirectory.getDirectory(RelativeFilePath.of("src/serialization"));
+            if (serializationDirectory != null && serializationDirectory?.getSourceFiles().length > 0) {
+                this.exportsManager.addExportsForDirectories([
+                    { nameOnDisk: "serialization", exportDeclaration: { namespaceExport: "serializers" } }
+                ]);
+                this.context.logger.debug("Generated serde layer.");
+            }
         }
 
         if (this.generateOAuthClients) {
@@ -556,16 +562,21 @@ export class SdkGenerator {
         }
     }
 
-    private generateTypeSchemas() {
+    private generateTypeSchemas(): { generated: boolean } {
+        let generated = false;
         for (const typeDeclaration of Object.values(this.intermediateRepresentation.types)) {
             this.withSourceFile({
                 filepath: this.typeSchemaDeclarationReferencer.getExportedFilepath(typeDeclaration.name),
                 run: ({ sourceFile, importsManager }) => {
+                    if (!generated) {
+                        generated = true;
+                    }
                     const context = this.generateSdkContext({ sourceFile, importsManager });
                     context.typeSchema.getGeneratedTypeSchema(typeDeclaration.name).writeToFile(context);
                 }
             });
         }
+        return { generated };
     }
 
     private generateErrorDeclarations() {
@@ -611,7 +622,8 @@ export class SdkGenerator {
         });
     }
 
-    private generateEndpointTypeSchemas() {
+    private generateEndpointTypeSchemas(): { generated: boolean } {
+        let generated = false;
         this.forEachService((service, packageId) => {
             for (const endpoint of service.endpoints) {
                 this.withSourceFile({
@@ -624,10 +636,14 @@ export class SdkGenerator {
                         context.sdkEndpointTypeSchemas
                             .getGeneratedEndpointTypeSchemas(packageId, endpoint.name)
                             .writeToFile(context);
+                        if (!generated) {
+                            generated = true;
+                        }
                     }
                 });
             }
         });
+        return { generated };
     }
 
     private generateRequestWrappers() {
@@ -652,7 +668,8 @@ export class SdkGenerator {
         });
     }
 
-    private generateInlinedRequestBodySchemas() {
+    private generateInlinedRequestBodySchemas(): { generated: boolean } {
+        let generated = false;
         this.forEachService((service, packageId) => {
             for (const endpoint of service.endpoints) {
                 if (endpoint.requestBody?.type === "inlinedRequestBody") {
@@ -666,11 +683,15 @@ export class SdkGenerator {
                             context.sdkInlinedRequestBodySchema
                                 .getGeneratedInlinedRequestBodySchema(packageId, endpoint.name)
                                 .writeToFile(context);
+                            if (!generated) {
+                                generated = true;
+                            }
                         }
                     });
                 }
             }
         });
+        return { generated };
     }
 
     private generateServiceDeclarations() {