ts-openapi-codegen 2.0.0-beta.7 → 2.0.0-beta.9

package/dist/common/VersionedSchema/OptionsVersioned/OptionsSchemaV2.js

@@ -1,17 +1,31 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.optionsSchemaV2 = void 0;
-const joi_1 = __importDefault(require("joi"));
+const zod_1 = require("zod");
 const core_1 = require("../../../core");
-const CommonSchemas_1 = require("../CommonSchemas");
-const mergeObjectSchemas_1 = require("../Utils/mergeObjectSchemas");
-/**
- * The scheme of a set of generator options (Версия 2).
- */
-exports.optionsSchemaV2 = (0, mergeObjectSchemas_1.mergeObjectSchemas)(joi_1.default.object({
-    input: joi_1.default.string().required(),
-    httpClient: joi_1.default.string().valid(...Object.values(core_1.HttpClient)),
-}), CommonSchemas_1.outputPathsSchema, CommonSchemas_1.specialParametersSchemas, CommonSchemas_1.additionalParametersSchema);
+const OptionsSchemaV1_1 = require("./OptionsSchemaV1");
+exports.optionsSchemaV2 = OptionsSchemaV1_1.optionsSchemaV1.omit({ client: true }).extend({
+    httpClient: zod_1.z.enum(core_1.HttpClient),
+});
+/*
+type TOptions = {
+    output: string;
+    input: string;
+    httpClient: HttpClient.FETCH | HttpClient.XHR | HttpClient.NODE | HttpClient.AXIOS;
+    outputCore: string | undefined;
+    outputServices: string | undefined;
+    outputModels: string | undefined;
+    outputSchemas: string | undefined;
+    useOptions: boolean | undefined;
+    useUnionTypes: boolean | undefined;
+    exportCore: boolean | undefined;
+    exportServices: boolean | undefined;
+    exportModels: boolean | undefined;
+    exportSchemas: boolean | undefined;
+    clean: boolean | undefined;
+    request: string | undefined;
+    interfacePrefix: string | undefined;
+    enumPrefix: string | undefined;
+    typePrefix: string | undefined;
+}
+*/

package/dist/common/VersionedSchema/OptionsVersioned/OptionsSchemaV3.d.ts

@@ -1,5 +1,26 @@
+import { z } from 'zod';
 /**
  * The scheme of a set of generator options (Версия 3).
  */
-export declare const optionsSchemaV3: import("joi").ObjectSchema<any>;
+export declare const optionsSchemaV3: z.ZodObject<{
+    useCancelableRequest: z.ZodOptional<z.ZodBoolean>;
+    input: z.ZodString;
+    output: z.ZodString;
+    outputCore: z.ZodOptional<z.ZodString>;
+    outputServices: z.ZodOptional<z.ZodString>;
+    outputModels: z.ZodOptional<z.ZodString>;
+    outputSchemas: z.ZodOptional<z.ZodString>;
+    useOptions: z.ZodOptional<z.ZodBoolean>;
+    useUnionTypes: z.ZodOptional<z.ZodBoolean>;
+    exportCore: z.ZodOptional<z.ZodBoolean>;
+    exportServices: z.ZodOptional<z.ZodBoolean>;
+    exportModels: z.ZodOptional<z.ZodBoolean>;
+    exportSchemas: z.ZodOptional<z.ZodBoolean>;
+    clean: z.ZodOptional<z.ZodBoolean>;
+    request: z.ZodOptional<z.ZodString>;
+    interfacePrefix: z.ZodOptional<z.ZodString>;
+    enumPrefix: z.ZodOptional<z.ZodString>;
+    typePrefix: z.ZodOptional<z.ZodString>;
+    httpClient: z.ZodEnum<typeof import("../../..").HttpClient>;
+}, z.core.$strip>;
 //# sourceMappingURL=OptionsSchemaV3.d.ts.map

package/dist/common/VersionedSchema/OptionsVersioned/OptionsSchemaV3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OptionsSchemaV3.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/OptionsVersioned/OptionsSchemaV3.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,eAAe,iCAAoE,CAAC"}
+{"version":3,"file":"OptionsSchemaV3.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/OptionsVersioned/OptionsSchemaV3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;iBAG1B,CAAC"}

package/dist/common/VersionedSchema/OptionsVersioned/OptionsSchemaV3.js

@@ -1,10 +1,36 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.optionsSchemaV3 = void 0;
+const zod_1 = require("zod");
 const CommonSchemas_1 = require("../CommonSchemas");
-const mergeObjectSchemas_1 = require("../Utils/mergeObjectSchemas");
 const OptionsSchemaV2_1 = require("./OptionsSchemaV2");
 /**
  * The scheme of a set of generator options (Версия 3).
  */
-exports.optionsSchemaV3 = (0, mergeObjectSchemas_1.mergeObjectSchemas)(OptionsSchemaV2_1.optionsSchemaV2, CommonSchemas_1.experimentalParametersSchema);
+exports.optionsSchemaV3 = zod_1.z.object({
+    ...OptionsSchemaV2_1.optionsSchemaV2.shape,
+    ...CommonSchemas_1.experimentalParametersSchema.shape,
+});
+/*
+type TOptions = {
+    output: string;
+    input: string;
+    httpClient: HttpClient.FETCH | HttpClient.XHR | HttpClient.NODE | HttpClient.AXIOS;
+    useCancelableRequest: boolean | undefined;
+    outputCore: string | undefined;
+    outputServices: string | undefined;
+    outputModels: string | undefined;
+    outputSchemas: string | undefined;
+    useOptions: boolean | undefined;
+    useUnionTypes: boolean | undefined;
+    exportCore: boolean | undefined;
+    exportServices: boolean | undefined;
+    exportModels: boolean | undefined;
+    exportSchemas: boolean | undefined;
+    clean: boolean | undefined;
+    request: string | undefined;
+    interfacePrefix: string | undefined;
+    enumPrefix: string | undefined;
+    typePrefix: string | undefined;
+}
+*/ 

package/dist/common/VersionedSchema/OptionsVersioned/OptionsSchemaV4.d.ts

@@ -1,6 +1,23 @@
-import Joi from "joi";
-/**
- * The scheme of a set of generator options (Версия 4).
- */
-export declare const optionsSchemaV4: Joi.ObjectSchema<any>;
+import { z } from "zod";
+import { HttpClient } from '../../../core';
+export declare const optionsSchemaV4: z.ZodObject<{
+    input: z.ZodString;
+    httpClient: z.ZodEnum<typeof HttpClient>;
+    sortByRequired: z.ZodOptional<z.ZodBoolean>;
+    useSeparatedIndexes: z.ZodOptional<z.ZodBoolean>;
+    useCancelableRequest: z.ZodOptional<z.ZodBoolean>;
+    request: z.ZodOptional<z.ZodString>;
+    interfacePrefix: z.ZodOptional<z.ZodString>;
+    enumPrefix: z.ZodOptional<z.ZodString>;
+    typePrefix: z.ZodOptional<z.ZodString>;
+    useOptions: z.ZodOptional<z.ZodBoolean>;
+    useUnionTypes: z.ZodOptional<z.ZodBoolean>;
+    excludeCoreServiceFiles: z.ZodOptional<z.ZodBoolean>;
+    includeSchemasFiles: z.ZodOptional<z.ZodBoolean>;
+    output: z.ZodString;
+    outputCore: z.ZodOptional<z.ZodString>;
+    outputServices: z.ZodOptional<z.ZodString>;
+    outputModels: z.ZodOptional<z.ZodString>;
+    outputSchemas: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 //# sourceMappingURL=OptionsSchemaV4.d.ts.map

package/dist/common/VersionedSchema/OptionsVersioned/OptionsSchemaV4.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OptionsSchemaV4.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/OptionsVersioned/OptionsSchemaV4.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AAMtB;;GAEG;AACH,eAAO,MAAM,eAAe,uBAS3B,CAAC"}
+{"version":3,"file":"OptionsSchemaV4.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/OptionsVersioned/OptionsSchemaV4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;iBAO1B,CAAC"}

package/dist/common/VersionedSchema/OptionsVersioned/OptionsSchemaV4.js

@@ -1,17 +1,36 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.optionsSchemaV4 = void 0;
-const joi_1 = __importDefault(require("joi"));
+const zod_1 = require("zod");
 const core_1 = require("../../../core");
 const CommonSchemas_1 = require("../CommonSchemas");
-const mergeObjectSchemas_1 = require("../Utils/mergeObjectSchemas");
-/**
- * The scheme of a set of generator options (Версия 4).
- */
-exports.optionsSchemaV4 = (0, mergeObjectSchemas_1.mergeObjectSchemas)(joi_1.default.object({
-    input: joi_1.default.string().required(),
-    httpClient: joi_1.default.string().valid(...Object.values(core_1.HttpClient)),
-}), CommonSchemas_1.outputPathsSchema, CommonSchemas_1.specialParametersSchemasV2, CommonSchemas_1.additionalParametersSchemaV2, CommonSchemas_1.experimentalParametersSchemaV2);
+exports.optionsSchemaV4 = zod_1.z.object({
+    ...CommonSchemas_1.outputPathsSchema.shape,
+    ...CommonSchemas_1.specialParametersSchemasV2.shape,
+    ...CommonSchemas_1.additionalParametersSchemaV2.shape,
+    ...CommonSchemas_1.experimentalParametersSchemaV2.shape,
+    input: zod_1.z.string().min(1),
+    httpClient: zod_1.z.enum(core_1.HttpClient),
+});
+/*
+type TOptions = {
+    input: string;
+    httpClient: HttpClient.FETCH | HttpClient.XHR | HttpClient.NODE | HttpClient.AXIOS;
+    output: string;
+    useCancelableRequest: boolean | undefined;
+    sortByRequired: boolean | undefined;
+    useSeparatedIndexes: boolean | undefined;
+    request: string | undefined;
+    interfacePrefix: string | undefined;
+    enumPrefix: string | undefined;
+    typePrefix: string | undefined;
+    useOptions: boolean | undefined;
+    useUnionTypes: boolean | undefined;
+    excludeCoreServiceFiles: boolean | undefined;
+    includeSchemasFiles: boolean | undefined;
+    outputCore: string | undefined;
+    outputServices: string | undefined;
+    outputModels: string | undefined;
+    outputSchemas: string | undefined;
+}
+*/

package/dist/common/VersionedSchema/OptionsVersioned/OptionsVersionedSchemas.d.ts

@@ -1,3 +1,4 @@
-import { VersionedSchema } from "../Types";
-export declare const optionsVersionedSchemas: VersionedSchema<Record<string, any>>[];
+import { z } from 'zod';
+import { VersionedSchema } from '../Types';
+export declare const optionsVersionedSchemas: VersionedSchema<z.ZodTypeAny>[];
 //# sourceMappingURL=OptionsVersionedSchemas.d.ts.map

package/dist/common/VersionedSchema/OptionsVersioned/OptionsVersionedSchemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OptionsVersionedSchemas.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/OptionsVersioned/OptionsVersionedSchemas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAM3C,eAAO,MAAM,uBAAuB,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAgBxE,CAAC"}
+{"version":3,"file":"OptionsVersionedSchemas.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/OptionsVersioned/OptionsVersionedSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAO3C,eAAO,MAAM,uBAAuB,EAAE,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,EAqBlE,CAAC"}

package/dist/common/VersionedSchema/OptionsVersioned/OptionsVersionedSchemas.js

@@ -2,24 +2,30 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.optionsVersionedSchemas = void 0;
 const Enums_1 = require("../Enums");
+const buildVersionedSchema_1 = require("../Utils/buildVersionedSchema");
 const OptionsSchemaV1_1 = require("./OptionsSchemaV1");
 const OptionsSchemaV2_1 = require("./OptionsSchemaV2");
 const OptionsSchemaV3_1 = require("./OptionsSchemaV3");
 const OptionsSchemaV4_1 = require("./OptionsSchemaV4");
-exports.optionsVersionedSchemas = [{
+exports.optionsVersionedSchemas = [
+    (0, buildVersionedSchema_1.buildVersionedSchema)({
         version: 'v1',
-        schema: OptionsSchemaV1_1.optionsSchemaV1,
+        base: OptionsSchemaV1_1.optionsSchemaV1,
         type: Enums_1.EVersionedSchemaType.OPTIONS,
-    }, {
+    }),
+    (0, buildVersionedSchema_1.buildVersionedSchema)({
         version: 'v2',
-        schema: OptionsSchemaV2_1.optionsSchemaV2,
+        base: OptionsSchemaV2_1.optionsSchemaV2,
         type: Enums_1.EVersionedSchemaType.OPTIONS,
-    }, {
+    }),
+    (0, buildVersionedSchema_1.buildVersionedSchema)({
         version: 'v3',
-        schema: OptionsSchemaV3_1.optionsSchemaV3,
+        base: OptionsSchemaV3_1.optionsSchemaV3,
         type: Enums_1.EVersionedSchemaType.OPTIONS,
-    }, {
+    }),
+    (0, buildVersionedSchema_1.buildVersionedSchema)({
         version: 'v4',
-        schema: OptionsSchemaV4_1.optionsSchemaV4,
+        base: OptionsSchemaV4_1.optionsSchemaV4,
         type: Enums_1.EVersionedSchemaType.OPTIONS,
-    }];
+    }),
+];

package/dist/common/VersionedSchema/Types.d.ts

@@ -1,9 +1,10 @@
-import Joi from 'joi';
+import { z } from 'zod';
 import { EVersionedSchemaType } from './Enums';
-export type VersionedSchema<T> = {
-    schema: Joi.Schema<T>;
-    type: EVersionedSchemaType;
+export type VersionedSchema<TSchema extends z.ZodTypeAny> = {
+    schema: TSchema;
+    baseSchema: z.ZodObject<any>;
     version: string;
+    type: EVersionedSchemaType;
 };
 export type SchemaMigrationPlan<From, To> = {
     fromVersion: string;
@@ -15,7 +16,6 @@ export type SchemaMigrationPlan<From, To> = {
      */
     description?: string;
 };
-export type TraverseHandler<T> = (value: any, recurse: (v: any) => void, result: T) => boolean;
 export type VersionMatchResult = {
     lastVersionIndex: number;
     latestVersion: string;

package/dist/common/VersionedSchema/Types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../../src/common/VersionedSchema/Types.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AAEtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAC7B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,IAAI,EAAE,EAAE,IAAI;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,EAAE,CAAC;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAGF,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;AAE/F,MAAM,MAAM,kBAAkB,GAAG;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACxB,CAAC"}
+{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../../src/common/VersionedSchema/Types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,MAAM,eAAe,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,IAAI;IACxD,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,oBAAoB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,IAAI,EAAE,EAAE,IAAI;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,EAAE,CAAC;IAC7B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACxB,CAAC"}

package/dist/common/VersionedSchema/Utils/__mocks__/compatibilityCases.d.ts

@@ -0,0 +1,16 @@
+import { EVersionedSchemaType } from '../../Enums';
+import { CompatibilityIssue } from '../compareShapes';
+type CompatibilityCase = {
+    type: EVersionedSchemaType;
+    from: string;
+    to: string;
+    expect: CompatibilityIssue[];
+};
+/**
+ * ВАЖНО!
+ * Для корректной работы механизма миграции версий опций необходимо после добавления
+ * новой схемы обновлять compatibilityCases.
+ */
+export declare const compatibilityCases: CompatibilityCase[];
+export {};
+//# sourceMappingURL=compatibilityCases.d.ts.map

package/dist/common/VersionedSchema/Utils/__mocks__/compatibilityCases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibilityCases.d.ts","sourceRoot":"","sources":["../../../../../src/common/VersionedSchema/Utils/__mocks__/compatibilityCases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,KAAK,iBAAiB,GAAG;IACrB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAChC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,iBAAiB,EA2EjD,CAAC"}

package/dist/common/VersionedSchema/Utils/__mocks__/compatibilityCases.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compatibilityCases = void 0;
+const Enums_1 = require("../../Enums");
+/**
+ * ВАЖНО!
+ * Для корректной работы механизма миграции версий опций необходимо после добавления
+ * новой схемы обновлять compatibilityCases.
+ */
+exports.compatibilityCases = [
+    {
+        type: Enums_1.EVersionedSchemaType.OPTIONS,
+        from: 'v1',
+        to: 'v2',
+        expect: [
+            { type: 'removed', key: 'client' },
+            { type: 'added', key: 'httpClient' },
+        ],
+    },
+    {
+        type: Enums_1.EVersionedSchemaType.OPTIONS,
+        from: 'v2',
+        to: 'v3',
+        expect: [{ type: 'added', key: 'useCancelableRequest' }],
+    },
+    {
+        type: Enums_1.EVersionedSchemaType.OPTIONS,
+        from: 'v3',
+        to: 'v4',
+        expect: [
+            { type: 'removed', key: 'exportCore' },
+            { type: 'removed', key: 'exportServices' },
+            { type: 'removed', key: 'exportModels' },
+            { type: 'removed', key: 'exportSchemas' },
+            { type: 'removed', key: 'clean' },
+            { type: 'added', key: 'excludeCoreServiceFiles' },
+            { type: 'added', key: 'includeSchemasFiles' },
+            { type: 'added', key: 'sortByRequired' },
+            { type: 'added', key: 'useSeparatedIndexes' },
+        ],
+    },
+    {
+        type: Enums_1.EVersionedSchemaType.MULTI_OPTIONS,
+        from: 'v1',
+        to: 'v2',
+        expect: [
+            { type: 'removed', key: 'client' },
+            { type: 'added', key: 'httpClient' },
+        ],
+    },
+    {
+        type: Enums_1.EVersionedSchemaType.MULTI_OPTIONS,
+        from: 'v2',
+        to: 'v3',
+        expect: [{ type: 'added', key: 'useCancelableRequest' }],
+    },
+    {
+        type: Enums_1.EVersionedSchemaType.MULTI_OPTIONS,
+        from: 'v4',
+        to: 'v5',
+        expect: [
+            { type: 'removed', key: 'exportCore' },
+            { type: 'removed', key: 'exportServices' },
+            { type: 'removed', key: 'exportModels' },
+            { type: 'removed', key: 'exportSchemas' },
+            { type: 'removed', key: 'clean' },
+            { type: 'added', key: 'excludeCoreServiceFiles' },
+            { type: 'added', key: 'includeSchemasFiles' },
+            { type: 'added', key: 'sortByRequired' },
+            { type: 'added', key: 'useSeparatedIndexes' },
+        ],
+    },
+    {
+        type: Enums_1.EVersionedSchemaType.UNIFIED_OPTIONS,
+        from: 'v1',
+        to: 'v2',
+        expect: [{ type: 'added', key: 'validationLibrary' }],
+    },
+    {
+        type: Enums_1.EVersionedSchemaType.UNIFIED_OPTIONS,
+        from: 'v2',
+        to: 'v3',
+        expect: [{ type: 'added', key: 'logLevel' }, { type: 'added', key: 'logTarget' }],
+    },
+];

package/dist/common/VersionedSchema/Utils/__tests__/compareShapes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compareShapes.test.d.ts.map

package/dist/common/VersionedSchema/Utils/__tests__/compareShapes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compareShapes.test.d.ts","sourceRoot":"","sources":["../../../../../src/common/VersionedSchema/Utils/__tests__/compareShapes.test.ts"],"names":[],"mappings":""}

package/dist/common/VersionedSchema/Utils/__tests__/compareShapes.test.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable simple-import-sort/imports */
+const node_test_1 = __importDefault(require("node:test"));
+const node_assert_1 = __importDefault(require("node:assert"));
+const compareShapes_1 = require("../compareShapes");
+const AllVersionedSchemas_1 = require("../../../VersionedSchema/AllVersionedSchemas/AllVersionedSchemas");
+const compatibilityCases_1 = require("../__mocks__/compatibilityCases");
+(0, node_test_1.default)('@unit: schema versions compatibility', () => {
+    for (const testCase of compatibilityCases_1.compatibilityCases) {
+        const { type, from, to, expect } = testCase;
+        const prev = AllVersionedSchemas_1.allVersionedSchemas.find(vs => vs.type === type && vs.version === `${type}_${from}`)?.baseSchema;
+        const next = AllVersionedSchemas_1.allVersionedSchemas.find(vs => vs.type === type && vs.version === `${type}_${to}`)?.baseSchema;
+        if (!prev || !next) {
+            return;
+        }
+        const issues = (0, compareShapes_1.compareShapes)(prev, next);
+        node_assert_1.default.deepStrictEqual(issues, expect, `${type} ${from} → ${to} mismatch`);
+    }
+});

package/dist/common/VersionedSchema/Utils/__tests__/migrateDataToLatestSchemaVersion.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=migrateDataToLatestSchemaVersion.test.d.ts.map

package/dist/common/VersionedSchema/Utils/__tests__/migrateDataToLatestSchemaVersion.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrateDataToLatestSchemaVersion.test.d.ts","sourceRoot":"","sources":["../../../../../src/common/VersionedSchema/Utils/__tests__/migrateDataToLatestSchemaVersion.test.ts"],"names":[],"mappings":""}

package/dist/common/VersionedSchema/Utils/__tests__/migrateDataToLatestSchemaVersion.test.js

@@ -0,0 +1,75 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable simple-import-sort/imports */
+const node_test_1 = __importDefault(require("node:test"));
+const node_assert_1 = __importDefault(require("node:assert"));
+const ValidationLibrary_enum_1 = require("../../../../core/types/enums/ValidationLibrary.enum");
+const Enums_1 = require("../../../Enums");
+const AllMigrationPlans_1 = require("../../AllVersionedSchemas/AllMigrationPlans");
+const AllVersionedSchemas_1 = require("../../AllVersionedSchemas/AllVersionedSchemas");
+const Enums_2 = require("../../Enums");
+const MultiOptionsMigrationPlan_1 = require("../../MultiOptionsVersioned/MultiOptionsMigrationPlan");
+const MultiOptionsVersionedSchemas_1 = require("../../MultiOptionsVersioned/MultiOptionsVersionedSchemas");
+const OptionsMigrationPlans_1 = require("../../OptionsVersioned/OptionsMigrationPlans");
+const OptionsVersionedSchemas_1 = require("../../OptionsVersioned/OptionsVersionedSchemas");
+const migrateDataToLatestSchemaVersion_1 = require("../migrateDataToLatestSchemaVersion");
+(0, node_test_1.default)('@unit: migrateDataToLatestSchemaVersion (options → latest options)', () => {
+    const rawInput = {
+        input: './spec.json',
+        output: './dist',
+        httpClient: 'fetch',
+    };
+    const result = (0, migrateDataToLatestSchemaVersion_1.migrateDataToLatestSchemaVersion)({
+        rawInput,
+        migrationPlans: OptionsMigrationPlans_1.optionsMigrationPlans,
+        versionedSchemas: OptionsVersionedSchemas_1.optionsVersionedSchemas,
+        migrationMode: Enums_1.EMigrationMode.VALIDATE_CONFIG,
+    });
+    node_assert_1.default.ok(result);
+    node_assert_1.default.strictEqual(result?.schemaType, Enums_2.EVersionedSchemaType.OPTIONS);
+    node_assert_1.default.strictEqual(result?.schemaVersion, 'v4');
+    node_assert_1.default.strictEqual(result?.value.httpClient, 'fetch');
+    node_assert_1.default.strictEqual(result?.value.httpClient, 'fetch');
+});
+(0, node_test_1.default)('@unit: migrateDataToLatestSchemaVersion (multi-options → latest multi-options)', () => {
+    const rawInput = {
+        httpClient: 'fetch',
+        items: [{ input: './spec.json', output: './dist' }],
+    };
+    const result = (0, migrateDataToLatestSchemaVersion_1.migrateDataToLatestSchemaVersion)({
+        rawInput,
+        migrationPlans: MultiOptionsMigrationPlan_1.multiOptionsMigrationPlan,
+        versionedSchemas: MultiOptionsVersionedSchemas_1.multiOptionsVersionedSchema,
+        migrationMode: Enums_1.EMigrationMode.VALIDATE_CONFIG,
+    });
+    node_assert_1.default.ok(result);
+    node_assert_1.default.strictEqual(result?.schemaType, Enums_2.EVersionedSchemaType.MULTI_OPTIONS);
+    node_assert_1.default.strictEqual(result?.schemaVersion, 'v5');
+    node_assert_1.default.strictEqual(result?.value.httpClient, 'fetch');
+    const item = result?.value.items?.[0];
+    node_assert_1.default.ok(item);
+    node_assert_1.default.strictEqual(item?.input, './spec.json');
+    node_assert_1.default.strictEqual(item?.output, './dist');
+});
+(0, node_test_1.default)('@unit: migrateDataToLatestSchemaVersion (unified schemas)', () => {
+    const rawInput = {
+        input: './spec.json',
+        output: './dist',
+        httpClient: 'fetch',
+        validationLibrary: ValidationLibrary_enum_1.ValidationLibrary.NONE,
+    };
+    const result = (0, migrateDataToLatestSchemaVersion_1.migrateDataToLatestSchemaVersion)({
+        rawInput,
+        migrationPlans: AllMigrationPlans_1.allMigrationPlans,
+        versionedSchemas: AllVersionedSchemas_1.allVersionedSchemas,
+        migrationMode: Enums_1.EMigrationMode.VALIDATE_CONFIG,
+    });
+    node_assert_1.default.ok(result);
+    node_assert_1.default.strictEqual(result?.schemaType, Enums_2.EVersionedSchemaType.UNIFIED_OPTIONS);
+    node_assert_1.default.strictEqual(result?.schemaVersion, 'UNIFIED_OPTIONS_v3');
+    node_assert_1.default.strictEqual(result?.value.httpClient, 'fetch');
+    node_assert_1.default.strictEqual(result?.value.validationLibrary, ValidationLibrary_enum_1.ValidationLibrary.NONE);
+});

package/dist/common/VersionedSchema/Utils/buildVersionedSchema.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import { EVersionedSchemaType } from '../Enums';
+import { VersionedSchema } from '../Types';
+type BuildVersionedSchemaParams<TBase extends z.ZodObject<any>> = {
+    base: TBase;
+    refine?: (data: z.infer<TBase>, ctx: z.RefinementCtx) => void;
+    version: string;
+    type: EVersionedSchemaType;
+};
+export declare function buildVersionedSchema<TBase extends z.ZodObject<any>>(params: BuildVersionedSchemaParams<TBase>): VersionedSchema<z.ZodTypeAny>;
+export {};
+//# sourceMappingURL=buildVersionedSchema.d.ts.map

package/dist/common/VersionedSchema/Utils/buildVersionedSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildVersionedSchema.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/Utils/buildVersionedSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,KAAK,0BAA0B,CAAC,KAAK,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI;IAC9D,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,aAAa,KAAK,IAAI,CAAC;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,oBAAoB,CAAC;CAC9B,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAC/D,MAAM,EAAE,0BAA0B,CAAC,KAAK,CAAC,GAC1C,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAW/B"}

package/dist/common/VersionedSchema/Utils/buildVersionedSchema.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildVersionedSchema = buildVersionedSchema;
+function buildVersionedSchema(params) {
+    const { base, refine, version, type } = params;
+    const schema = refine ? base.superRefine(refine) : base;
+    return {
+        schema,
+        baseSchema: base,
+        version,
+        type,
+    };
+}

package/dist/common/VersionedSchema/Utils/compareShapes.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export type CompatibilityIssue = {
+    type: 'removed';
+    key: string;
+} | {
+    type: 'added';
+    key: string;
+} | {
+    type: 'type-changed';
+    key: string;
+} | {
+    type: 'optional-to-required';
+    key: string;
+};
+export declare function compareShapes(prev: z.ZodObject<any>, next: z.ZodObject<any>): CompatibilityIssue[];
+//# sourceMappingURL=compareShapes.d.ts.map

package/dist/common/VersionedSchema/Utils/compareShapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compareShapes.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/Utils/compareShapes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3L,wBAAgB,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,kBAAkB,EAAE,CAiClG"}

package/dist/common/VersionedSchema/Utils/compareShapes.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareShapes = compareShapes;
+function compareShapes(prev, next) {
+    const prevShape = prev.shape;
+    const nextShape = next.shape;
+    const issues = [];
+    // removed / changed / optional → required
+    for (const key of Object.keys(prevShape)) {
+        if (!(key in nextShape)) {
+            issues.push({ type: 'removed', key });
+            continue;
+        }
+        const prevField = prevShape[key];
+        const nextField = nextShape[key];
+        if (prevField._def.typeName !== nextField._def.typeName) {
+            issues.push({ type: 'type-changed', key });
+        }
+        if (prevField.isOptional() && !nextField.isOptional()) {
+            issues.push({ type: 'optional-to-required', key });
+        }
+    }
+    // added
+    for (const key of Object.keys(nextShape)) {
+        if (!(key in prevShape)) {
+            issues.push({ type: 'added', key });
+        }
+    }
+    return issues;
+}

package/dist/common/VersionedSchema/Utils/determineBestMatchingSchemaVersion.d.ts

@@ -1,3 +1,4 @@
+import { z } from 'zod';
 import { VersionedSchema, VersionMatchResult } from '../Types';
-export declare function determineBestMatchingSchemaVersion(inputData: Record<string, any>, versionedSchemas: VersionedSchema<Record<string, any>>[]): VersionMatchResult;
+export declare function determineBestMatchingSchemaVersion(inputData: Record<string, any>, versionedSchemas: VersionedSchema<z.ZodTypeAny>[]): VersionMatchResult;
 //# sourceMappingURL=determineBestMatchingSchemaVersion.d.ts.map

package/dist/common/VersionedSchema/Utils/determineBestMatchingSchemaVersion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"determineBestMatchingSchemaVersion.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/Utils/determineBestMatchingSchemaVersion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAM/D,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,gBAAgB,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,kBAAkB,CA4C/J"}
+{"version":3,"file":"determineBestMatchingSchemaVersion.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/Utils/determineBestMatchingSchemaVersion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAK/D,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,gBAAgB,EAAE,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,GAAG,kBAAkB,CA4CxJ"}