@ama-sdk/schematics 11.1.0-prerelease.4 → 11.1.0-prerelease.41

package/README.md

@@ -127,16 +127,16 @@ Please note that revivers are generated for SDKs that use:
 
 If your specification file includes dates, there are multiple options for the generation of your SDK involving the global property option `stringifyDate`:
 
-- By default, the option `stringifyDate` is false so dates will be generated as either `utils.Date`, `utils.DateTime`, or `Date`.
+- By default, the option `stringifyDate` is set to `true`. Set it to `false` if you want date-time objects to be generated 
+  as `Date` and date objects to be generated as `utils.Date`.
   For more information related to these types, check out this [documentation](https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/schematics/schematics/typescript/shell/templates/base#manage-dates).
-- To leave the handling of the timezone to the application and generate the dates as `string` types, the option `stringifyDate` can be set to true. <br>
-  This can be done by adding `--global-property stringifyDate` to the generator command.
-- If an existing SDK contains stringified dates that need to be reverted to their expected formats, you can regenerate the SDK by removing the `stringifyDate` option from the global properties (since it is false by default).
+  This can be done by adding `--global-property stringifyDate=false` to the generator command or by adding the global property
+to the `openapitools.json`.
 
-Example to stringify dates:
+Example to use `Date`:
 
 ```shell
-yarn schematics @ama-sdk/schematics:typescript-core --spec-path ./swagger-spec.yaml --global-property stringifyDate
+yarn schematics @ama-sdk/schematics:typescript-core --spec-path ./swagger-spec.yaml --global-property stringifyDate=false
 ```
 
 ##### Extensible models
@@ -214,7 +214,7 @@ described global properties `stringifyDate` and  `allowModelExtension`:
         "output": ".",
         "inputSpec": "./openapi-spec.yaml", // or "./openapi-spec.json" according to the specification format
         "globalProperty": {
-          "stringifyDate": true,
+          "stringifyDate": false,
           "allowModelExtension": true
         }
       }
@@ -252,6 +252,7 @@ yarn schematics @ama-sdk/schematics:migrate --from 10.0.0 [--to 11.0.0]
 ```
 
 > [!NOTE]
+>
 > - The `--from` parameter is mandatory to provide the version of the original `@ama-sdk/schematics` package from which the rules should be run.
 > - The *optional* `--to` parameter allows to indicate a version until which the rules should be run. The current installed version will be used if not provided.
 

package/migration.json

@@ -6,10 +6,20 @@
       "description": "Updates of @ama-sdk/schematics to v10.0.*",
       "factory": "./schematics/ng-update/index#updateV10_0"
     },
+    "migration-v10_1": {
+      "version": "10.1.0-alpha.0",
+      "description": "Updates of @ama-sdk/schematics to v10.1.*",
+      "factory": "./schematics/ng-update/index#updateV10_1"
+    },
     "migration-v10_3": {
       "version": "10.3.0-alpha.0",
       "description": "Updates of @ama-sdk/schematics to v10.3.*",
       "factory": "./schematics/ng-update/index#updateV10_3"
+    },
+    "migration-v11_0": {
+      "version": "11.0.0-alpha.0",
+      "description": "Updates of @ama-sdk/schematics to v11.0.*",
+      "factory": "./schematics/ng-update/index#updateV11_0"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ama-sdk/schematics",
-  "version": "11.1.0-prerelease.4",
+  "version": "11.1.0-prerelease.41",
   "publishConfig": {
     "access": "public"
   },
@@ -57,12 +57,12 @@
     }
   },
   "peerDependencies": {
-    "@ama-sdk/core": "^11.1.0-prerelease.4",
+    "@ama-sdk/core": "^11.1.0-prerelease.41",
     "@angular-devkit/core": "~18.0.0",
     "@angular-devkit/schematics": "~18.0.0",
     "@angular-devkit/schematics-cli": "^18.0.5",
     "@angular/cli": "~18.0.0",
-    "@o3r/schematics": "^11.1.0-prerelease.4",
+    "@o3r/schematics": "^11.1.0-prerelease.41",
     "@openapitools/openapi-generator-cli": "~2.13.0",
     "@schematics/angular": "~18.0.0"
   },
@@ -79,16 +79,16 @@
     "tslib": "^2.6.2"
   },
   "devDependencies": {
-    "@ama-sdk/core": "^11.1.0-prerelease.4",
+    "@ama-sdk/core": "^11.1.0-prerelease.41",
     "@angular-devkit/schematics-cli": "^18.0.5",
     "@angular-eslint/eslint-plugin": "~18.0.0",
     "@angular/cli": "~18.0.0",
     "@nx/eslint-plugin": "~19.3.0",
     "@nx/jest": "~19.3.0",
-    "@o3r/build-helpers": "^11.1.0-prerelease.4",
-    "@o3r/eslint-plugin": "^11.1.0-prerelease.4",
-    "@o3r/schematics": "^11.1.0-prerelease.4",
-    "@o3r/test-helpers": "^11.1.0-prerelease.4",
+    "@o3r/build-helpers": "^11.1.0-prerelease.41",
+    "@o3r/eslint-plugin": "^11.1.0-prerelease.41",
+    "@o3r/schematics": "^11.1.0-prerelease.41",
+    "@o3r/test-helpers": "^11.1.0-prerelease.41",
     "@openapitools/openapi-generator-cli": "~2.13.0",
     "@schematics/angular": "~18.0.0",
     "@stylistic/eslint-plugin-ts": "^2.0.0",
@@ -99,16 +99,16 @@
     "@types/node": "^20.0.0",
     "@types/pid-from-port": "^1.1.0",
     "@types/semver": "^7.3.13",
-    "@typescript-eslint/eslint-plugin": "^7.2.0",
-    "@typescript-eslint/parser": "^7.2.0",
-    "@typescript-eslint/utils": "~7.14.1",
+    "@typescript-eslint/eslint-plugin": "^7.14.1",
+    "@typescript-eslint/parser": "^7.14.1",
+    "@typescript-eslint/utils": "^7.14.1",
     "commit-and-tag-version": "^12.0.0",
     "copyfiles": "^2.4.1",
     "cpy-cli": "^5.0.0",
     "eslint": "^8.57.0",
     "eslint-import-resolver-node": "^0.3.9",
     "eslint-plugin-jest": "~28.6.0",
-    "eslint-plugin-jsdoc": "~48.5.0",
+    "eslint-plugin-jsdoc": "~48.8.0",
     "eslint-plugin-prefer-arrow": "~1.2.3",
     "eslint-plugin-unicorn": "^54.0.0",
     "isomorphic-fetch": "~3.0.0",
@@ -121,14 +121,14 @@
     "openapi-types": "^12.0.0",
     "pid-from-port": "^1.1.3",
     "semver": "^7.5.2",
-    "ts-jest": "~29.1.2",
+    "ts-jest": "~29.2.0",
     "ts-node": "~10.9.2",
     "type-fest": "^4.10.2",
     "typescript": "~5.4.2"
   },
   "generatorDependencies": {
-    "@swc/cli": "~0.3.0",
-    "@swc/core": "~1.6.0",
+    "@swc/cli": "~0.4.0",
+    "@swc/core": "~1.7.0",
     "@swc/helpers": "~0.5.0",
     "@commitlint/cli": "^19.0.0",
     "@commitlint/config-conventional": "^19.0.0",

package/schematics/helpers/generators.d.ts

@@ -1,7 +1,7 @@
 /** Name of the specification file copied locally (without extension) */
-export declare const LOCAL_SPEC_FILENAME = "swagger-spec";
+export declare const LOCAL_SPEC_FILENAME = "open-api";
 /** Extension of the Specification file in YAML format */
 export declare const SPEC_YAML_EXTENSION = "yaml";
 /** Extension of the Specification file in JSON format */
-export declare const SPEC_JSON_EXTENSION = "yaml";
+export declare const SPEC_JSON_EXTENSION = "json";
 //# sourceMappingURL=generators.d.ts.map

package/schematics/helpers/generators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../../schematics/helpers/generators.ts"],"names":[],"mappings":"AACA,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAG1C,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,SAAS,CAAC"}
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../../schematics/helpers/generators.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAE1C,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,SAAS,CAAC"}

package/schematics/helpers/generators.js

@@ -1,12 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SPEC_JSON_EXTENSION = exports.SPEC_YAML_EXTENSION = exports.LOCAL_SPEC_FILENAME = void 0;
-// TODO: Change to `openapi` in v11 (ref: #1745)
 /** Name of the specification file copied locally (without extension) */
-exports.LOCAL_SPEC_FILENAME = 'swagger-spec';
+exports.LOCAL_SPEC_FILENAME = 'open-api';
 /** Extension of the Specification file in YAML format */
 exports.SPEC_YAML_EXTENSION = 'yaml';
-// TODO: Change to `json` in v11 (ref: #1745)
 /** Extension of the Specification file in JSON format */
-exports.SPEC_JSON_EXTENSION = 'yaml';
+exports.SPEC_JSON_EXTENSION = 'json';
 //# sourceMappingURL=generators.js.map

package/schematics/migrate/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../schematics/migrate/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,8BAA8B,EAAE,MAAM,UAAU,CAAC;AAkC1D;;;GAGG;AACH,eAAO,MAAM,OAAO,YAAa,8BAA8B,wBAG9D,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../schematics/migrate/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,8BAA8B,EAAE,MAAM,UAAU,CAAC;AAqC1D;;;GAGG;AACH,eAAO,MAAM,OAAO,YAAa,8BAA8B,wBAG9D,CAAC"}

package/schematics/migrate/index.js

@@ -3,12 +3,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.migrate = void 0;
 const schematics_1 = require("@o3r/schematics");
 const node_path_1 = require("node:path");
+const update_regen_script_1 = require("../ng-update/typescript/v11.0/update-regen-script");
 const semver_1 = require("semver");
 const is_typescript_project_1 = require("../helpers/is-typescript-project");
 const update_openapiversion_1 = require("../ng-update/typescript/v10.3/update-openapiversion");
 /* eslint-disable @typescript-eslint/naming-convention */
 const tsMigrationMap = {
-    '~10.3.2': (0, update_openapiversion_1.updateOpenApiVersionInProject)()
+    '~10.3.2': (0, update_openapiversion_1.updateOpenApiVersionInProject)(),
+    '11.0.*': [
+        update_regen_script_1.updateRegenScript
+    ]
 };
 /* eslint-enable @typescript-eslint/naming-convention */
 /**

package/schematics/migrate/schema.d.ts

@@ -1,4 +1,4 @@
-/** Schematic Option */
+/** Migrate Schematics Options */
 export interface MigrateSchematicsSchemaOptions {
     /** Starting version from which the migration scripts are executed */
     from: string;

package/schematics/migrate/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../schematics/migrate/schema.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,MAAM,WAAW,8BAA8B;IAC7C,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,2FAA2F;IAC3F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../schematics/migrate/schema.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,WAAW,8BAA8B;IAC7C,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,2FAA2F;IAC3F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC"}

package/schematics/ng-update/index.d.ts

@@ -3,4 +3,16 @@ import type { Rule } from '@angular-devkit/schematics';
  * update of Otter library V10.0
  */
 export declare function updateV10_0(): Rule;
+/**
+ * update of Otter library V10.1
+ */
+export declare function updateV10_1(): Rule;
+/**
+ * update of Otter library V10.3
+ */
+export declare function updateV10_3(): Rule;
+/**
+ * update of Otter library V11.0
+ */
+export declare function updateV11_0(): Rule;
 //# sourceMappingURL=index.d.ts.map

package/schematics/ng-update/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../schematics/ng-update/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAIvD;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAQlC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../schematics/ng-update/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AASvD;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAQlC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAQlC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAQlC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAQlC"}

package/schematics/ng-update/index.js

@@ -2,7 +2,7 @@
 /* eslint-disable @typescript-eslint/naming-convention */
 /* eslint-disable camelcase */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateV10_0 = void 0;
+exports.updateV11_0 = exports.updateV10_3 = exports.updateV10_1 = exports.updateV10_0 = void 0;
 const typescript_1 = require("./typescript");
 const is_typescript_project_1 = require("../helpers/is-typescript-project");
 /**
@@ -17,4 +17,40 @@ function updateV10_0() {
     };
 }
 exports.updateV10_0 = updateV10_0;
+/**
+ * update of Otter library V10.1
+ */
+function updateV10_1() {
+    return (tree, context) => {
+        if ((0, is_typescript_project_1.isTypescriptSdk)(tree)) {
+            return (0, typescript_1.updateV10_1)()(tree, context);
+        }
+        return tree;
+    };
+}
+exports.updateV10_1 = updateV10_1;
+/**
+ * update of Otter library V10.3
+ */
+function updateV10_3() {
+    return (tree, context) => {
+        if ((0, is_typescript_project_1.isTypescriptSdk)(tree)) {
+            return (0, typescript_1.updateV10_3)()(tree, context);
+        }
+        return tree;
+    };
+}
+exports.updateV10_3 = updateV10_3;
+/**
+ * update of Otter library V11.0
+ */
+function updateV11_0() {
+    return (tree, context) => {
+        if ((0, is_typescript_project_1.isTypescriptSdk)(tree)) {
+            return (0, typescript_1.updateV11_0)()(tree, context);
+        }
+        return tree;
+    };
+}
+exports.updateV11_0 = updateV11_0;
 //# sourceMappingURL=index.js.map

package/schematics/ng-update/typescript/index.d.ts

@@ -11,4 +11,8 @@ export declare function updateV10_1(): Rule;
  * Update of Ama-sdk library V10.3
  */
 export declare function updateV10_3(): Rule;
+/**
+ * Update of Ama-sdk library V11
+ */
+export declare function updateV11_0(): Rule;
 //# sourceMappingURL=index.d.ts.map

package/schematics/ng-update/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../schematics/ng-update/typescript/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAS,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAKzD;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAQlC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAMlC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAMlC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../schematics/ng-update/typescript/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAS,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAOzD;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAQlC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAMlC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAMlC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAOlC"}

package/schematics/ng-update/typescript/index.js

@@ -2,11 +2,13 @@
 /* eslint-disable @typescript-eslint/naming-convention */
 /* eslint-disable camelcase */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateV10_3 = exports.updateV10_1 = exports.updateV10_0 = void 0;
+exports.updateV11_0 = exports.updateV10_3 = exports.updateV10_1 = exports.updateV10_0 = void 0;
 const schematics_1 = require("@angular-devkit/schematics");
 const script_removal_1 = require("./v10.0/script-removal");
 const add_presets_renovate_1 = require("./v10.1/add-presets-renovate");
 const update_openapiversion_1 = require("./v10.3/update-openapiversion");
+const update_regen_script_1 = require("./v11.0/update-regen-script");
+const update_openapitools_1 = require("./v11.0/update-openapitools");
 /**
  * update of Otter library V10.0
  */
@@ -39,4 +41,15 @@ function updateV10_3() {
     return (0, schematics_1.chain)(updateRules);
 }
 exports.updateV10_3 = updateV10_3;
+/**
+ * Update of Ama-sdk library V11
+ */
+function updateV11_0() {
+    const updateRules = [
+        update_regen_script_1.updateRegenScript,
+        update_openapitools_1.updateOpenapitoolsFile
+    ];
+    return (0, schematics_1.chain)(updateRules);
+}
+exports.updateV11_0 = updateV11_0;
 //# sourceMappingURL=index.js.map

package/schematics/ng-update/typescript/v11.0/update-openapitools.d.ts

@@ -0,0 +1,7 @@
+import type { Rule } from '@angular-devkit/schematics';
+/**
+ * Update Regen Script to base remove 'swagger' keyword
+ * @param tree
+ */
+export declare const updateOpenapitoolsFile: Rule;
+//# sourceMappingURL=update-openapitools.d.ts.map

package/schematics/ng-update/typescript/v11.0/update-openapitools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-openapitools.d.ts","sourceRoot":"","sources":["../../../../../schematics/ng-update/typescript/v11.0/update-openapitools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAIvD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,IAUpC,CAAC"}

package/schematics/ng-update/typescript/v11.0/update-openapitools.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateOpenapitoolsFile = void 0;
+const schematics_1 = require("@o3r/schematics");
+const generators_1 = require("../../../helpers/generators");
+/**
+ * Update Regen Script to base remove 'swagger' keyword
+ * @param tree
+ */
+const updateOpenapitoolsFile = (tree) => {
+    const files = (0, schematics_1.findFilesInTree)(tree.root, (p) => p.endsWith('openapitools.json'));
+    files.forEach((file) => {
+        const configFileContent = tree.readText(file.path);
+        if (configFileContent.includes('swagger-spec.yaml')) {
+            tree.overwrite(file.path, configFileContent.replace(/swagger-spec\.yaml/g, `${generators_1.LOCAL_SPEC_FILENAME}.yaml`));
+        }
+    });
+};
+exports.updateOpenapitoolsFile = updateOpenapitoolsFile;
+//# sourceMappingURL=update-openapitools.js.map

package/schematics/ng-update/typescript/v11.0/update-regen-script.d.ts

@@ -0,0 +1,7 @@
+import type { Rule } from '@angular-devkit/schematics';
+/**
+ * Update Regen Script to base remove 'swagger' keyword
+ * @param tree
+ */
+export declare const updateRegenScript: Rule;
+//# sourceMappingURL=update-regen-script.d.ts.map

package/schematics/ng-update/typescript/v11.0/update-regen-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-regen-script.d.ts","sourceRoot":"","sources":["../../../../../schematics/ng-update/typescript/v11.0/update-regen-script.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAOvD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,IAoB/B,CAAC"}

package/schematics/ng-update/typescript/v11.0/update-regen-script.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateRegenScript = void 0;
+const schematics_1 = require("@o3r/schematics");
+const generators_1 = require("../../../helpers/generators");
+const SCRIPT_REGEN_LABEL = 'spec:regen';
+/**
+ * Update Regen Script to base remove 'swagger' keyword
+ * @param tree
+ */
+const updateRegenScript = (tree) => {
+    const files = (0, schematics_1.findFilesInTree)(tree.root, (p) => p.endsWith('package.json'));
+    files.forEach((file) => {
+        const packageJson = tree.readJson(file.path);
+        if (!packageJson.scripts || !Object.keys(packageJson.scripts).includes(SCRIPT_REGEN_LABEL)) {
+            return;
+        }
+        const swaggerFilePath = file.path.replace(/package\.json$/, 'swagger-spec.yaml');
+        if (!tree.exists(swaggerFilePath)) {
+            return;
+        }
+        packageJson.scripts[SCRIPT_REGEN_LABEL] = packageJson.scripts[SCRIPT_REGEN_LABEL].replace(/swagger-spec\.yaml/g, `${generators_1.LOCAL_SPEC_FILENAME}.yaml`);
+        tree.overwrite(file.path, JSON.stringify(packageJson, null, 2));
+        const openApiFilePath = file.path.replace(/package\.json$/, `${generators_1.LOCAL_SPEC_FILENAME}.yaml`);
+        tree.rename(swaggerFilePath, openApiFilePath);
+    });
+};
+exports.updateRegenScript = updateRegenScript;
+//# sourceMappingURL=update-regen-script.js.map

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

@@ -124,12 +124,16 @@ 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.
+The Otter framework has introduced the `utils.Date` and `utils.DateTime` objects to replace the `Date` implementation and convert the date returned by the API as if it were in the
+timezone of the user.
 
-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.
+Dates can be generated as `utils.Date` or `string` depending on the value of the `stringifyDate` option. This ensures that the timezone will not impact the date. 
+In the case of `date-time` objects, the default type used is the native `string` and `Date` type depending on the `stringifyDate` option value.
+
+If you want to generate a date-time using `utils.DateTime`, you can do it at property level thanks to the `x-local-timezone` vendor.
+
+If you need to keep the timezone information, extend the model and 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 (the first one being completely generated from the API specifications).
 
 Simple example:
 ```yaml
@@ -140,6 +144,8 @@ Simple example:
     properties:
       departureDateTime:
         type: string
+        x-local-timezone: true
+        description: If this vendor extension is present send dates without their timezone
         format: date-time
 ```
 Base model generated
@@ -197,23 +203,3 @@ export * from './flight/index';
 
 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.
-
-### 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:
-
-```yaml
-properties:
-  timestamp:
-    title: timestamp
-    description: >-
-      Timestamp when event is triggered. UTC time (server time), with a
-      format similar to yyyy-MM-ddThh:mm:ss.sTZD. Refer to the pattern
-    type: string
-    format: date-time
-    x-date-timezone:
-      description: If this vendor extension is present send dates with the timezone
-    pattern: >-
-      ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}.[0-9]{1,3}([Z]|([+][0-9]{2}:?[0-9]{2}$))
-    example: '2013-12-31T19:20:30.45+01:00'
-```

package/src/public_api.d.ts

@@ -0,0 +1,6 @@
+export * from '../schematics/helpers/generators';
+export type * from '../schematics/helpers/open-api-tools-configuration';
+export type * from '../schematics/typescript/core/schema';
+export type * from '../schematics/typescript/mock/schema';
+export type * from '../schematics/typescript/shell/schema';
+//# sourceMappingURL=public_api.d.ts.map

package/src/public_api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public_api.d.ts","sourceRoot":"","sources":["../../src/public_api.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,mBAAmB,oDAAoD,CAAC;AACxE,mBAAmB,sCAAsC,CAAC;AAC1D,mBAAmB,sCAAsC,CAAC;AAC1D,mBAAmB,uCAAuC,CAAC"}

package/src/public_api.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("../schematics/helpers/generators"), exports);
+//# sourceMappingURL=public_api.js.map