@ama-sdk/schematics 9.0.0-rc.1 → 9.0.0-rc.13

package/README.md

@@ -75,3 +75,19 @@ yarn schematics @ama-sdk/schematics:java-client-core --spec-path ./swagger-spec.
 ```
 
 [Default swagger config](./schematics/java/client-core/swagger-codegen-java-client/config/swagger-codegen-config.json) will be used if `--swagger-config-path` is not provided.
+
+### Debug the typescript generator
+The OpenApi generator extracts an enhanced JSON data model from the specification YAML and uses this data model to feed the templates to generate the code.
+If there is an issue with the files generated with the spec provided, the generator provides debugging features that log this data model.
+
+You can use global property options to pass one or both of the following options:
+* debugModel - logs the full JSON structure used to generate models
+* debugOperations - logs the full JSON structure used to generate operations
+
+Example:
+```shell
+yarn schematics @ama-sdk/schematics:typescript-core --spec-path ./swagger-spec.yaml --global-property debugModels,debugOperations
+```
+You can also use npx instead of yarn in the command.
+
+You can correlate this data model with the [templates](https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/schematics/schematics/typescript/core/openapi-codegen-typescript/src/main/resources/typescriptFetch) used by the generator.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ama-sdk/schematics",
-  "version": "9.0.0-rc.1",
+  "version": "9.0.0-rc.13",
   "description": "Swagger specification SDK Generator by schematics",
   "scripts": {
     "nx": "nx",
@@ -41,7 +41,7 @@
     }
   },
   "peerDependencies": {
-    "@ama-sdk/core": "^9.0.0-rc.1",
+    "@ama-sdk/core": "^9.0.0-rc.13",
     "@angular-devkit/core": "~16.0.5",
     "@angular-devkit/schematics": "~16.0.5",
     "@angular-devkit/schematics-cli": "~16.0.5",
@@ -52,7 +52,7 @@
   "dependencies": {
     "@angular-devkit/core": "~16.0.5",
     "@angular-devkit/schematics": "~16.0.5",
-    "@o3r/dev-tools": "^9.0.0-rc.1",
+    "@o3r/dev-tools": "^9.0.0-rc.13",
     "js-yaml": "^4.1.0",
     "minimatch": "^9.0.0",
     "rxjs": "^7.8.1",
@@ -61,14 +61,14 @@
     "tslib": "^2.5.3"
   },
   "devDependencies": {
-    "@ama-sdk/core": "^9.0.0-rc.1",
+    "@ama-sdk/core": "^9.0.0-rc.13",
     "@angular-devkit/schematics-cli": "~16.0.5",
     "@angular-eslint/eslint-plugin": "~16.0.3",
     "@angular/cli": "~16.0.5",
     "@nx/jest": "~16.5.0",
-    "@o3r/build-helpers": "^9.0.0-rc.1",
-    "@o3r/eslint-plugin": "^9.0.0-rc.1",
-    "@o3r/schematics": "^9.0.0-rc.1",
+    "@o3r/build-helpers": "^9.0.0-rc.13",
+    "@o3r/eslint-plugin": "^9.0.0-rc.13",
+    "@o3r/schematics": "^9.0.0-rc.13",
     "@openapitools/openapi-generator-cli": "~2.6.0",
     "@schematics/angular": "~16.0.5",
     "@types/jest": "~29.5.2",

package/schematics/code-generator/open-api-cli-generator/open-api-cli.generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open-api-cli.generator.d.ts","sourceRoot":"","sources":["../../../../schematics/code-generator/open-api-cli-generator/open-api-cli.generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAoC,iBAAiB,EAAC,MAAM,wBAAwB,CAAC;AAI5F;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,aAAa,CAAC,iBAAiB,CAAC;IAEvE,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,KAAK,GAAG,MAAM,CAAC;IAClD,SAAS,KAAK,oBAAoB,IAAI,KAAK,GAAG,MAAM,CAEnD;IAED,kBAAkB;IAClB,SAAS,CAAC,QAAQ,CAAC,aAAa,6BAA6B;gBAEjD,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,EAAE,CAAA;KAAE;IAK9D;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAelC;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAsBpB,kBAAkB;IAClB,SAAS,CAAC,iBAAiB,0BAA2C;IAEtE,kBAAkB;IAClB,SAAS,CAAC,uBAAuB,oBAAoB;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,yBAI5C,iBAAiB,wBAclD;CACH"}
+{"version":3,"file":"open-api-cli.generator.d.ts","sourceRoot":"","sources":["../../../../schematics/code-generator/open-api-cli-generator/open-api-cli.generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAoC,iBAAiB,EAAC,MAAM,wBAAwB,CAAC;AAI5F;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,aAAa,CAAC,iBAAiB,CAAC;IAEvE,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,KAAK,GAAG,MAAM,CAAC;IAClD,SAAS,KAAK,oBAAoB,IAAI,KAAK,GAAG,MAAM,CAEnD;IAED,kBAAkB;IAClB,SAAS,CAAC,QAAQ,CAAC,aAAa,6BAA6B;gBAEjD,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,EAAE,CAAA;KAAE;IAK9D;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAelC;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAuBpB,kBAAkB;IAClB,SAAS,CAAC,iBAAiB,0BAA2C;IAEtE,kBAAkB;IAClB,SAAS,CAAC,uBAAuB,oBAAoB;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,yBAI5C,iBAAiB,wBAclD;CACH"}

package/schematics/code-generator/open-api-cli-generator/open-api-cli.generator.js

@@ -73,7 +73,8 @@ class OpenApiCliGenerator extends code_generator_1.CodeGenerator {
             '-g', generatorOptions.generatorName,
             '-i', generatorOptions.specPath,
             ...generatorOptions.specConfigPath ? ['-c', generatorOptions.specConfigPath] : [],
-            '-o', generatorOptions.outputPath
+            '-o', generatorOptions.outputPath,
+            ...generatorOptions.globalProperty ? ['--global-property', generatorOptions.globalProperty] : []
         ];
         return new Promise((resolve, reject) => {
             (0, node_child_process_1.spawn)(this.packageManagerRunner, args, spawnOptions)

package/schematics/code-generator/open-api-cli-generator/open-api-cli.options.d.ts

@@ -10,7 +10,7 @@ export type OpenApiCliOptions = CodegenTaskOptions & {
      *  - the one defined in your openapitools.json
      *  - the latest version if openapitools.json is missing
      *
-     *  @default null
+     *  @default ''
      */
     generatorVersion: string;
     /**
@@ -25,6 +25,15 @@ export type OpenApiCliOptions = CodegenTaskOptions & {
      * @default path to our own custom typescript generator
      */
     generatorCustomPath: string;
+    /**
+     * Comma separated string of options to give to the openapi-generator-cli
+     *
+     * @example debugModels to log the full json structure used to generate models
+     * @example debugOperations to log the full json structure used to generate operations
+     *
+     * @default ''
+     */
+    globalProperty: string;
 };
 /**
  * Default options to run our custom typescript generator

package/schematics/code-generator/open-api-cli-generator/open-api-cli.options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open-api-cli.options.d.ts","sourceRoot":"","sources":["../../../../schematics/code-generator/open-api-cli-generator/open-api-cli.options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,mBAAmB,CAAC;AAGrD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,GAAG;IACnD;;;;;;;OAOG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iCAAiC,EAAE,iBAO/C,CAAC"}
+{"version":3,"file":"open-api-cli.options.d.ts","sourceRoot":"","sources":["../../../../schematics/code-generator/open-api-cli-generator/open-api-cli.options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,mBAAmB,CAAC;AAGrD;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,GAAG;IACnD;;;;;;;OAOG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iCAAiC,EAAE,iBAQ/C,CAAC"}

package/schematics/code-generator/open-api-cli-generator/open-api-cli.options.js

@@ -11,6 +11,7 @@ exports.defaultTypescriptGeneratorOptions = {
     generatorCustomPath: path.join(__dirname, '..', '..', 'typescript', 'core', 'openapi-codegen-typescript', 'target', 'typescriptFetch-openapi-generator.jar'),
     specPath: 'swagger-spec.yaml',
     outputPath: '.',
-    specConfigPath: ''
+    specConfigPath: '',
+    globalProperty: ''
 };
 //# sourceMappingURL=open-api-cli.options.js.map

package/schematics/helpers/node-install.d.ts

@@ -19,9 +19,6 @@ export interface NodePackageInstallTaskOptions {
 }
 /**
  * Install dev dependency on your application
- *
- * Note: it should not be moved to other packages as it should run before the installation
- * of peer dependencies
  */
 export declare class DevInstall extends NodePackageInstallTask {
     quiet: boolean;

package/schematics/helpers/node-install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-install.d.ts","sourceRoot":"","sources":["../../../schematics/helpers/node-install.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,kBAAkB,CAAC,EAAE,wBAAwB,GAAG,EAAE,GAAG,SAAS,GAAG,IAAI,GAAG,wBAAwB,CAErI;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,EAAE,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,sBAAsB;IAC7C,KAAK,UAAS;gBAET,OAAO,CAAC,EAAE,6BAA6B;IAMnD,kBAAkB;IACX,eAAe;;;;;;;;;;CAYvB;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,sBAAsB;IAC7C,KAAK,UAAS;gBAET,OAAO,CAAC,EAAE,6BAA6B;IAMnD,kBAAkB;IACX,eAAe;;;;;;;;;;;;;CAavB"}
+{"version":3,"file":"node-install.d.ts","sourceRoot":"","sources":["../../../schematics/helpers/node-install.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,kBAAkB,CAAC,EAAE,wBAAwB,GAAG,EAAE,GAAG,SAAS,GAAG,IAAI,GAAG,wBAAwB,CAErI;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,EAAE,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,sBAAsB;IAC7C,KAAK,UAAS;gBAET,OAAO,CAAC,EAAE,6BAA6B;IAMnD,kBAAkB;IACX,eAAe;;;;;;;;;;CAYvB;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,sBAAsB;IAC7C,KAAK,UAAS;gBAET,OAAO,CAAC,EAAE,6BAA6B;IAMnD,kBAAkB;IACX,eAAe;;;;;;;;;;;;;CAavB"}

package/schematics/helpers/node-install.js

@@ -14,9 +14,6 @@ function getPackageManagerName(enforcedNpmManager) {
 exports.getPackageManagerName = getPackageManagerName;
 /**
  * Install dev dependency on your application
- *
- * Note: it should not be moved to other packages as it should run before the installation
- * of peer dependencies
  */
 class DevInstall extends tasks_1.NodePackageInstallTask {
     constructor(options) {

package/schematics/typescript/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../schematics/typescript/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,IAAI,EAKL,MAAM,4BAA4B,CAAC;AASpC,OAAO,EAAE,2CAA2C,EAAE,MAAM,UAAU,CAAC;AAgBvE;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,2CAA2C,GAAG,IAAI,CA+GlG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../schematics/typescript/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,IAAI,EAKL,MAAM,4BAA4B,CAAC;AASpC,OAAO,EAAE,2CAA2C,EAAE,MAAM,UAAU,CAAC;AAgBvE;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,2CAA2C,GAAG,IAAI,CAgHlG"}

package/schematics/typescript/core/index.js

@@ -25,6 +25,7 @@ const getPathObjectTemplate = (pathObj) => {
 function ngGenerateTypescriptSDK(options) {
     const specPath = path.resolve(process.cwd(), options.specPath);
     const targetPath = options.directory || '/';
+    const globalProperty = options.globalProperty;
     const generateOperationFinder = async () => {
         const swayOptions = {
             definition: path.resolve(options.specPath)
@@ -100,7 +101,7 @@ function ngGenerateTypescriptSDK(options) {
         return () => tree;
     };
     const runGeneratorRule = (tree, context) => {
-        const generatorOptions = { specPath };
+        const generatorOptions = { specPath, globalProperty };
         const packageJsonFile = JSON.parse(((0, node_fs_1.readFileSync)(path.join(__dirname, '..', '..', '..', 'package.json'))).toString());
         const packageOpenApiSupportedVersion = packageJsonFile.openApiSupportedVersion?.replace(/\^|~/, '');
         let openApiVersion = '';

package/schematics/typescript/core/schema.d.ts

@@ -8,5 +8,14 @@ export interface NgGenerateTypescriptSDKCoreSchematicsSchema extends JsonObject
     packageManager: 'npm' | 'yarn' | '';
     /** Path to the spec generation configuration */
     specConfigPath: string;
+    /**
+     * Comma separated string of options to give to the openapi-generator-cli
+     *
+     * @example debugModels to log the full json structure used to generate models
+     * @example debugOperations to log the full json structure used to generate operations
+     *
+     * @default ''
+     */
+    globalProperty: string;
 }
 //# sourceMappingURL=schema.d.ts.map

package/schematics/typescript/core/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../schematics/typescript/core/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,2CAA4C,SAAQ,UAAU;IAC7E,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IAEjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAElB,sDAAsD;IACtD,cAAc,EAAE,KAAK,GAAG,MAAM,GAAG,EAAE,CAAC;IAEpC,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../schematics/typescript/core/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,2CAA4C,SAAQ,UAAU;IAC7E,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IAEjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAElB,sDAAsD;IACtD,cAAc,EAAE,KAAK,GAAG,MAAM,GAAG,EAAE,CAAC;IAEpC,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAC;IAEvB;;;;;;;OAOG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/schematics/typescript/core/schema.json

@@ -32,6 +32,11 @@
       ],
       "description": "Package manager to be used in the generated SDK",
       "default": ""
+    },
+    "globalProperty": {
+      "type": "string",
+      "description": "Comma separated string of options to give to the openapi-generator-cli",
+      "default": ""
     }
   },
   "additionalProperties": true,

package/schematics/typescript/shell/schema.d.ts

@@ -1,8 +1,8 @@
 import type { JsonObject } from '@angular-devkit/core';
 export interface NgGenerateTypescriptSDKShellSchematicsSchema extends JsonObject {
-    /** Project name (NPM package scope) */
+    /** Project name (NPM package scope, package.json name will be @{projectName}/{packageName}) */
     name: string;
-    /** Package name */
+    /** Package name (package.json name will be @{projectName}/{packageName}) */
     package: string;
     /** Project description */
     description: string;

package/schematics/typescript/shell/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../schematics/typescript/shell/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,4CAA6C,SAAQ,UAAU;IAC9E,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IAEb,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAEhB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IAEpB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAElB,sDAAsD;IACtD,cAAc,EAAE,KAAK,GAAG,MAAM,GAAG,EAAE,CAAC;IAEpC,uBAAuB;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../schematics/typescript/shell/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,4CAA6C,SAAQ,UAAU;IAC9E,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC;IAEb,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAEhB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IAEpB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAElB,sDAAsD;IACtD,cAAc,EAAE,KAAK,GAAG,MAAM,GAAG,EAAE,CAAC;IAEpC,uBAAuB;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/schematics/typescript/shell/schema.json

@@ -6,13 +6,13 @@
   "properties": {
     "name": {
       "type": "string",
-      "description": "Project name (NPM package scope)",
-      "x-prompt": "Project name (NPM package scope)?"
+      "description": "Project name (NPM package scope, package.json name will be @{projectName}/{packageName})",
+      "x-prompt": "Project name (NPM package scope, package.json name will be @{projectName}/{packageName})?"
     },
     "package": {
       "type": "string",
-      "description": "Package name",
-      "x-prompt": "Package name?",
+      "description": "Package name (package.json name will be @{projectName}/{packageName})",
+      "x-prompt": "Package name (package.json name will be @{projectName}/{packageName})?",
       "default": "sdk"
     },
     "description": {

package/schematics/typescript/shell/templates/base/readme.md

@@ -109,11 +109,95 @@ You can build and run UT with:
 yarn test
 ```
 
-## Vendor extensions
+## Manage dates
+
+### The timezone issue
+Managing dates with timezones has always been a bit painful in front end applications.
+Let's give a concrete example to understand the problem:
+An API returns the date and hour of your flight in the timezone of the airport location. In our use case, let's say the departure airport is on GTM+7 : 2023-07-10T00:37:00.000+07:00.
+The timezone sent is the one from the airport, here GMT+7. If you just use the Date(), the computer browser will convert this in its own timezone.
+For example, if the user is in GMT+2 you will end up displaying the following: 2023-07-09T19:37:00.000+02:00.
+This is not what you want. You want the exact date time of the flight at the airport timezone, not the one of your user's computer.
+However, there might be cases where you might still need the timezone information.
+For example, you want to be able to display that the flight is in X hours.
+You will need to compute this information with the two timezones -- the airport's and the user's.
+
+### Solution proposed to remove the timezone: utils.DateTime
+We have introduced the utils.Date object to replace the Date implementation and ignore the timezone.
+As we need to get rid of the timezones more often than not, this will be our default behavior.
+By default, the Date models are replaced with utils.Date.
+
+When we need to keep the timezone information, we create a new field directly in the SDK.
+As this field does not exist in the specification, it will not be part of the base model but of the core model instead.
+
+Simple example:
+```yaml
+  Flight:
+    type: "object"
+    required:
+      - departureDateTime
+    properties:
+      departureDateTime:
+        type: string
+        format: date-time
+```
+Base model generated
+```typescript
+// flight.ts generated in base models
+export interface Flight {
+  /** @see utils.DateTime */
+  departureDateTime: utils.DateTime;
+}
+```
+You need to create a core model to store the timezone information (src/models/core/flight.ts):
+```typescript
+import type { IgnoreEnum } from '@ama-sdk/core';
+import type { Flight } from '../../base/flight/flight';
+export type FlightStopCoreIfy<T extends IgnoreEnum<Flight>> = T & {
+  /** Departure date time of the flight considering timezone */
+  departureDateTimeConsideringTimezone?: Date;
+};
+```
+
+And an associated reviver (src/models/core/flight.reviver.ts):
+```typescript
+import type { Flight } from '../../base/flight/flight';
+import type { reviveFlight } from '../../base/flight/flight.reviver';
+import type { FlightCoreIfy } from './flight';
+
+/**
+ * @param baseRevive
+ */
+export function reviveFlightFactory<R extends typeof reviveFlight>(baseRevive: R) {
+  const reviver = <T extends Flight = Flight>(data: any, dictionaries?: any) => {
+    const originalData: any = {...data};
+    const revivedData = baseRevive<FlightCoreIfy<T>>(data, dictionaries);
+    if (!revivedData) {
+      return;
+    }
+    revivedData.departureDateTimeConsideringTimezone = originalData.departureDateTimeConsideringTimezone && new Date(originalData.departureDateTimeConsideringTimezone)
+      || originalData.departureDateTime && new Date(originalData.departureDateTime);
+    return revivedData;
+  };
+  return reviver;
+}
+```
+
+And export it here (src/models/core/flight/index.ts):
+```typescript
+export * from './flight';
+export * from './flight.reviver';
+```
+
+And here (src/models/core/index.ts):
+```typescript
+export * from './flight/index';
+```
 
-These are some of the available configurations using vendor extensions in the swagger spec
+You can now use departureDateTimeConsideringTimezone to access the timezone information.
+See [utils.Date](https://github.com/AmadeusITGroup/otter/blob/main/packages/%40ama-sdk/core/src/fwk/date.ts) for more information.
 
-### Manage timezone in date
+### How to keep the timezone (prevent Date replacement with utils.Date)
 
 In order to add the timezone to your timestamp property you can add the x-date-timezone extension in your yaml, for example: