feat: extend to support type-builder

Author: mnahkies

integration-tests-definitions/todo-lists.yaml

@@ -171,6 +171,9 @@ components:
         created:
           type: string
           format: date-time
+          x-alpha-transform:
+            fn: (it) => new Date(it)
+            type: Date
         updated:
           type: string
           format: date-time

integration-tests/typescript-angular/src/generated/todo-lists.yaml/models.ts

@@ -12,7 +12,7 @@ export type t_CreateUpdateTodoList = {
 }
 
 export type t_TodoList = {
-  created: string
+  created: Date
   id: string
   incompleteItemCount: number
   name: string

integration-tests/typescript-axios/src/generated/todo-lists.yaml/models.ts

@@ -12,7 +12,7 @@ export type t_CreateUpdateTodoList = {
 }
 
 export type t_TodoList = {
-  created: string
+  created: Date
   id: string
   incompleteItemCount: number
   name: string

integration-tests/typescript-fetch/src/generated/todo-lists.yaml/models.ts

@@ -12,7 +12,7 @@ export type t_CreateUpdateTodoList = {
 }
 
 export type t_TodoList = {
-  created: string
+  created: Date
   id: string
   incompleteItemCount: number
   name: string

integration-tests/typescript-koa/src/generated/todo-lists.yaml/models.ts

@@ -8,7 +8,7 @@ export type t_Error = {
 }
 
 export type t_TodoList = {
-  created: string
+  created: Date
   id: string
   incompleteItemCount: number
   name: string

integration-tests/typescript-koa/src/generated/todo-lists.yaml/schemas.ts

@@ -11,7 +11,10 @@ export const s_TodoList = z.object({
   name: z.string(),
   totalItemCount: z.coerce.number(),
   incompleteItemCount: z.coerce.number(),
-  created: z.string().datetime({ offset: true }),
+  created: z
+    .string()
+    .datetime({ offset: true })
+    .transform((it) => new Date(it)),
   updated: z.string().datetime({ offset: true }),
 })
 

packages/openapi-code-generator/src/core/openapi-types-normalized.ts

@@ -9,7 +9,12 @@ export interface IRModelBase {
   nullable: boolean /* false */
   readOnly: boolean /* false */
 
-  "x-alpha-transform"?: string | undefined
+  "x-alpha-transform"?:
+    | {
+        fn?: string | undefined
+        type?: string | undefined
+      }
+    | undefined
 }
 
 export type IRModelNumericFormat = "int32" | "int64" | "float" | "double"

packages/openapi-code-generator/src/core/openapi-types.ts

@@ -249,8 +249,13 @@ export interface Schema {
   deprecated?: boolean | undefined
   // xml?: XML | undefined
 
-  // TODO: not yet supported by type-builder or joi
-  "x-alpha-transform"?: string | undefined
+  // TODO: not yet supported by joi
+  "x-alpha-transform"?:
+    | {
+        fn?: string | undefined
+        type?: string | undefined
+      }
+    | undefined
 }
 
 export interface Discriminator {

packages/openapi-code-generator/src/typescript/common/schema-builders/abstract-schema-builder.ts

@@ -180,8 +180,10 @@ export abstract class AbstractSchemaBuilder<
           oneOf: [],
           required: [],
           anyOf: [parameter.schema, parameter.schema.items],
-          "x-alpha-transform": ((it: unknown) =>
-            Array.isArray(it) || it === undefined ? it : [it]).toString(),
+          "x-alpha-transform": {
+            fn: ((it: unknown) =>
+              Array.isArray(it) || it === undefined ? it : [it]).toString(),
+          },
         }
       } else {
         model.properties[parameter.name] = parameter.schema
@@ -326,8 +328,8 @@ export abstract class AbstractSchemaBuilder<
 
     result = required ? this.required(result) : this.optional(result)
 
-    if (model["x-alpha-transform"]) {
-      result = this.transform(result, model["x-alpha-transform"])
+    if (model["x-alpha-transform"]?.fn) {
+      result = this.transform(result, model["x-alpha-transform"]?.fn)
     }
 
     return result

packages/openapi-code-generator/src/typescript/common/type-builder.ts

@@ -145,7 +145,9 @@ export class TypeBuilder implements ICompilable {
       result.push(...schemaObject.anyOf.flatMap(this.schemaObjectToTypes))
     }
 
-    if (result.length === 0) {
+    if (schemaObject["x-alpha-transform"]?.type) {
+      result.push(schemaObject["x-alpha-transform"]?.type)
+    } else if (result.length === 0) {
       switch (schemaObject.type) {
         case "array": {
           result.push(array(this.schemaObjectToType(schemaObject.items)))