ts-openapi-codegen 2.0.0-beta.0 → 2.0.0-beta.10

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/createFieldTransformationMigration.d.ts

@@ -0,0 +1,32 @@
+import { SchemaMigrationPlan } from '../Types';
+/**
+ * Creates a migration plan that transforms fields using a custom migration function.
+ * Use this for migrations that require field renaming, restructuring, or complex transformations
+ * that cannot be handled by createDefaultFieldsMigration or createTrivialMigration.
+ *
+ * @param fromVersion - Source version
+ * @param toVersion - Target version
+ * @param migrate - Custom migration function that transforms the data
+ * @param description - Optional description of what this migration does
+ * @returns A migration plan with the custom transformation
+ *
+ * @example
+ * ```ts
+ * // Rename field: client -> httpClient
+ * createFieldTransformationMigration('v1', 'v2',
+ *   ({ client, ...otherProps }) => ({ ...otherProps, httpClient: client }),
+ *   'Renames client field to httpClient'
+ * )
+ *
+ * // Transform items array
+ * createFieldTransformationMigration('v3', 'v4',
+ *   ({ items, input, output, ...otherProps }) => ({
+ *     ...otherProps,
+ *     items: items.map(el => ({ ...el, input, output }))
+ *   }),
+ *   'Moves input/output fields into each item'
+ * )
+ * ```
+ */
+export declare function createFieldTransformationMigration<From extends Record<string, any>, To extends Record<string, any>>(fromVersion: string, toVersion: string, migrate: (input: From) => To, description?: string): SchemaMigrationPlan<From, To>;
+//# sourceMappingURL=createFieldTransformationMigration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createFieldTransformationMigration.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/Utils/createFieldTransformationMigration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/G,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,EAAE,EAC5B,WAAW,CAAC,EAAE,MAAM,GACrB,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC,CAO/B"}

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

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFieldTransformationMigration = createFieldTransformationMigration;
+/**
+ * Creates a migration plan that transforms fields using a custom migration function.
+ * Use this for migrations that require field renaming, restructuring, or complex transformations
+ * that cannot be handled by createDefaultFieldsMigration or createTrivialMigration.
+ *
+ * @param fromVersion - Source version
+ * @param toVersion - Target version
+ * @param migrate - Custom migration function that transforms the data
+ * @param description - Optional description of what this migration does
+ * @returns A migration plan with the custom transformation
+ *
+ * @example
+ * ```ts
+ * // Rename field: client -> httpClient
+ * createFieldTransformationMigration('v1', 'v2',
+ *   ({ client, ...otherProps }) => ({ ...otherProps, httpClient: client }),
+ *   'Renames client field to httpClient'
+ * )
+ *
+ * // Transform items array
+ * createFieldTransformationMigration('v3', 'v4',
+ *   ({ items, input, output, ...otherProps }) => ({
+ *     ...otherProps,
+ *     items: items.map(el => ({ ...el, input, output }))
+ *   }),
+ *   'Moves input/output fields into each item'
+ * )
+ * ```
+ */
+function createFieldTransformationMigration(fromVersion, toVersion, migrate, description) {
+    return {
+        fromVersion,
+        toVersion,
+        migrate,
+        description: description || `Custom field transformation migration from ${fromVersion} to ${toVersion}`,
+    };
+}

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"}

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.determineBestMatchingSchemaVersion = determineBestMatchingSchemaVersion;
-const getErrorFieldsFromValidation_1 = require("./getErrorFieldsFromValidation");
+const validateZodOptions_1 = require("../../Validation/validateZodOptions");
 const getUniqueKeysFromSchemas_1 = require("./getUniqueKeysFromSchemas");
 const getUniqueObjectKeys_1 = require("./getUniqueObjectKeys");
 // Determining the most appropriate schema version
@@ -12,8 +12,8 @@ function determineBestMatchingSchemaVersion(inputData, versionedSchemas) {
     const inputKeys = (0, getUniqueObjectKeys_1.getUniqueObjectKeys)(inputData);
     const matchingSchemas = versionedSchemas
         .map(({ schema, version }, idx) => {
-        const { error } = schema.validate(inputData, { allowUnknown: true });
-        const errorFields = (0, getErrorFieldsFromValidation_1.getErrorFieldsFromValidation)(error).filter(err => err.type !== 'any.only');
+        const validationResult = (0, validateZodOptions_1.validateZodOptionsRaw)(schema, inputData);
+        const errorFields = !validationResult.success ? validationResult.error.issues.filter(err => err.code !== 'invalid_value') : [];
         return errorFields.length === 0 ? { version, index: idx } : null;
     })
         .filter((match) => match !== null);
@@ -27,8 +27,8 @@ function determineBestMatchingSchemaVersion(inputData, versionedSchemas) {
     }
     const schemaMatches = versionedSchemas.map(({ schema, version }, idx) => {
         const schemaKeys = (0, getUniqueKeysFromSchemas_1.getUniqueKeysFromSchemas)([schema]);
-        const { error } = schema.validate(inputData, { allowUnknown: true });
-        const errorFields = (0, getErrorFieldsFromValidation_1.getErrorFieldsFromValidation)(error).filter(err => err.type !== 'any.only');
+        const validationResult = (0, validateZodOptions_1.validateZodOptionsRaw)(schema, inputData);
+        const errorFields = !validationResult.success ? validationResult.error.issues.filter(err => err.code !== 'invalid_value') : [];
         const matchingKeys = inputKeys.filter(key => schemaKeys.has(key));
         return { index: idx, version, errorFields, matchingKeys };
     });

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

@@ -1,3 +1,3 @@
-import Joi from "joi";
-export declare function getCurrentErrorMessage(error: Joi.ValidationError, replaicingKeysMap: Map<string, string>): void;
+import { z } from 'zod';
+export declare function getCurrentErrorMessage(error: z.ZodError, replaicingKeysMap: Map<string, string>): void;
 //# sourceMappingURL=getCurrentErrorMessage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getCurrentErrorMessage.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/Utils/getCurrentErrorMessage.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AAKtB,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,GAAG,CAAC,eAAe,EAAE,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,QAQxG"}
+{"version":3,"file":"getCurrentErrorMessage.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/Utils/getCurrentErrorMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,QAqB/F"}

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

@@ -1,14 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCurrentErrorMessage = getCurrentErrorMessage;
-const getErrorFieldsFromValidation_1 = require("./getErrorFieldsFromValidation");
+const formatZodError_1 = require("../../Validation/formatZodError");
 const getKeyByMapValue_1 = require("./getKeyByMapValue");
 function getCurrentErrorMessage(error, replaicingKeysMap) {
-    const { path } = (0, getErrorFieldsFromValidation_1.getErrorFieldsFromValidation)(error)[0];
-    const reverseKey = (0, getKeyByMapValue_1.getKeyByMapValue)(replaicingKeysMap, path);
-    let currentMessage = error.message;
-    if (reverseKey) {
-        currentMessage = error.message.replace(path, reverseKey);
+    if (!error || error.issues.length === 0) {
+        return;
     }
-    throw new Error(currentMessage);
+    const messages = new Set();
+    error.issues.forEach(issue => {
+        const path = (0, formatZodError_1.formatZodPath)(issue.path);
+        const reverseKey = (0, getKeyByMapValue_1.getKeyByMapValue)(replaicingKeysMap, path);
+        let currentMessage = issue.message;
+        if (reverseKey) {
+            currentMessage = error.message.replace(path, reverseKey);
+        }
+        messages.add(currentMessage);
+    });
+    const result = Array.from(messages.values());
+    throw new Error(result.join('\n'));
 }

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

@@ -0,0 +1,16 @@
+import { SchemaMigrationPlan } from '../Types';
+/**
+ * Gets the latest version from a migration plans array.
+ * Returns the `toVersion` of the last migration plan in the array.
+ *
+ * @param migrationPlans - Array of migration plans
+ * @returns The latest version string (e.g., 'v4')
+ *
+ * @example
+ * ```ts
+ * const latestVersion = getLatestVersionFromMigrationPlans(optionsMigrationPlans);
+ * // Returns 'v4'
+ * ```
+ */
+export declare function getLatestVersionFromMigrationPlans(migrationPlans: SchemaMigrationPlan<Record<string, any>, Record<string, any>>[]): string;
+//# sourceMappingURL=getLatestVersionFromMigrationPlans.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getLatestVersionFromMigrationPlans.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/Utils/getLatestVersionFromMigrationPlans.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,wBAAgB,kCAAkC,CAC9C,cAAc,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,GAChF,MAAM,CAOR"}

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

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLatestVersionFromMigrationPlans = getLatestVersionFromMigrationPlans;
+/**
+ * Gets the latest version from a migration plans array.
+ * Returns the `toVersion` of the last migration plan in the array.
+ *
+ * @param migrationPlans - Array of migration plans
+ * @returns The latest version string (e.g., 'v4')
+ *
+ * @example
+ * ```ts
+ * const latestVersion = getLatestVersionFromMigrationPlans(optionsMigrationPlans);
+ * // Returns 'v4'
+ * ```
+ */
+function getLatestVersionFromMigrationPlans(migrationPlans) {
+    if (migrationPlans.length === 0) {
+        throw new Error('Migration plans array is empty. Cannot determine latest version.');
+    }
+    const lastPlan = migrationPlans[migrationPlans.length - 1];
+    return lastPlan.toVersion;
+}

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

@@ -1,8 +1,8 @@
-import Joi from 'joi';
+import { z } from 'zod';
 /**
  * Get all the unique parameter keys of all Joi schemes in the array
  * @param schemas array of joi schemes
  * @returns All the unique parameter keys of all Joi schemes in the array
  */
-export declare function getUniqueKeysFromSchemas(schemas: Joi.Schema[]): Set<string>;
+export declare function getUniqueKeysFromSchemas(schemas: z.ZodTypeAny[]): Set<string>;
 //# sourceMappingURL=getUniqueKeysFromSchemas.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getUniqueKeysFromSchemas.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/Utils/getUniqueKeysFromSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AAKtB;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,eAQ7D"}
+{"version":3,"file":"getUniqueKeysFromSchemas.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/Utils/getUniqueKeysFromSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqBxB;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,CAAC,CAAC,UAAU,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAQ7E"}