@hosterai/types 0.0.18 → 0.0.20

package/dist/decorators/all-or-none-validator.spec.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/dist/decorators/all-or-none-validator.spec.js

@@ -0,0 +1,91 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const class_validator_1 = require("class-validator");
+const all_or_none_validator_1 = require("./all-or-none.validator");
+// Pairs
+let PairDto = class PairDto {
+    constructor(data) { Object.assign(this, data); }
+};
+PairDto = __decorate([
+    (0, all_or_none_validator_1.AllOrNoneProperty)(['a', 'b']),
+    __metadata("design:paramtypes", [Object])
+], PairDto);
+// Multiple pairs
+let MultiPairDto = class MultiPairDto {
+    constructor(data) { Object.assign(this, data); }
+};
+MultiPairDto = __decorate([
+    (0, all_or_none_validator_1.AllOrNoneProperty)([
+        ['a', 'b'],
+        ['c', 'd'],
+    ]),
+    __metadata("design:paramtypes", [Object])
+], MultiPairDto);
+// Group of 3+
+let GroupDto = class GroupDto {
+    constructor(data) { Object.assign(this, data); }
+};
+GroupDto = __decorate([
+    (0, all_or_none_validator_1.AllOrNoneProperty)(['x', 'y', 'z']),
+    __metadata("design:paramtypes", [Object])
+], GroupDto);
+describe('AllOrNoneProperty', () => {
+    // Single pair
+    it('passes when both pair fields are absent', async () => {
+        const dto = new PairDto({});
+        const errors = await (0, class_validator_1.validate)(dto);
+        expect(errors.length).toBe(0);
+    });
+    it('fails when one of pair fields is present and the other is absent', async () => {
+        const dto = new PairDto({ a: 1 });
+        const errors = await (0, class_validator_1.validate)(dto);
+        expect(errors.length).toBeGreaterThan(0);
+    });
+    it('passes when both pair fields are present', async () => {
+        const dto = new PairDto({ a: 1, b: 2 });
+        const errors = await (0, class_validator_1.validate)(dto);
+        expect(errors.length).toBe(0);
+    });
+    // Multiple pairs
+    it('passes when all pairs are absent', async () => {
+        const dto = new MultiPairDto({});
+        const errors = await (0, class_validator_1.validate)(dto);
+        expect(errors.length).toBe(0);
+    });
+    it('passes when all pairs are present', async () => {
+        const dto = new MultiPairDto({ a: 1, b: 2, c: 3, d: 4 });
+        const errors = await (0, class_validator_1.validate)(dto);
+        expect(errors.length).toBe(0);
+    });
+    it('fails when one pair violates the rule', async () => {
+        const dto = new MultiPairDto({ a: 1, b: 2, c: 3 });
+        const errors = await (0, class_validator_1.validate)(dto);
+        expect(errors.length).toBeGreaterThan(0);
+    });
+    // 3+ group
+    it('passes when all group fields are absent', async () => {
+        const dto = new GroupDto({});
+        const errors = await (0, class_validator_1.validate)(dto);
+        expect(errors.length).toBe(0);
+    });
+    it('fails when only a subset of group fields are present', async () => {
+        const dto = new GroupDto({ x: 1 });
+        const errors = await (0, class_validator_1.validate)(dto);
+        expect(errors.length).toBeGreaterThan(0);
+    });
+    it('passes when all group fields are present', async () => {
+        const dto = new GroupDto({ x: 1, y: 2, z: 3 });
+        const errors = await (0, class_validator_1.validate)(dto);
+        expect(errors.length).toBe(0);
+    });
+});

package/dist/decorators/all-or-none.validator.d.ts

@@ -0,0 +1,2 @@
+import { ValidationOptions } from 'class-validator';
+export declare function AllOrNoneProperty(keysOrGroups: [string, string] | [string, string][] | string[] | string[][], validationOptions?: ValidationOptions): (constructor: Function) => void;

package/dist/decorators/all-or-none.validator.js

@@ -0,0 +1,71 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AllOrNoneProperty = AllOrNoneProperty;
+const class_validator_1 = require("class-validator");
+let AllOrNoneConstraint = class AllOrNoneConstraint {
+    validate(_, args) {
+        const object = args.object;
+        const input = args.constraints[0];
+        // Normalize to an array of groups, each group being string[] (length >= 2 preferred)
+        let groups = [];
+        if (Array.isArray(input)) {
+            if (input.length > 0 && typeof input[0] === 'string') {
+                // Single group given as string[] (could be pair or more than 2)
+                groups = [input];
+            }
+            else {
+                // Array of groups (pairs or larger)
+                groups = input.map((g) => g);
+            }
+        }
+        const has = (k) => object[k] !== undefined && object[k] !== null;
+        return groups.every((group) => {
+            if (!Array.isArray(group) || group.length < 2)
+                return true; // Ignore invalid/misconfigured groups
+            const statuses = group.map((k) => has(k));
+            const allPresent = statuses.every(Boolean);
+            const allAbsent = statuses.every((v) => !v);
+            return allPresent || allAbsent;
+        });
+    }
+    defaultMessage(args) {
+        const input = args.constraints[0];
+        let groups = [];
+        if (Array.isArray(input)) {
+            if (input.length > 0 && typeof input[0] === 'string') {
+                groups = [input];
+            }
+            else {
+                groups = input.map((g) => g);
+            }
+        }
+        if (groups.length === 1) {
+            const g = groups[0];
+            const list = g.join(', ');
+            return `All of (${list}) must be provided together or omitted together`;
+        }
+        const list = groups.map((g) => `(${g.join('/')})`).join(', ');
+        return `Each group must be provided together or omitted together: ${list}`;
+    }
+};
+AllOrNoneConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'AllOrNone', async: false })
+], AllOrNoneConstraint);
+function AllOrNoneProperty(keysOrGroups, validationOptions) {
+    return function (constructor) {
+        (0, class_validator_1.registerDecorator)({
+            name: 'AllOrNone',
+            target: constructor,
+            propertyName: '',
+            options: validationOptions,
+            constraints: [keysOrGroups],
+            validator: AllOrNoneConstraint,
+        });
+    };
+}

package/dist/decorators/min-less-or-equal-validator.spec.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/dist/decorators/min-less-or-equal-validator.spec.js

@@ -0,0 +1,60 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const class_validator_1 = require("class-validator");
+const min_less_or_equal_validator_1 = require("./min-less-or-equal.validator");
+let MinMaxDto = class MinMaxDto {
+    constructor(data) { Object.assign(this, data); }
+};
+MinMaxDto = __decorate([
+    (0, min_less_or_equal_validator_1.MinLessOrEqualMaxProperty)(['min', 'max']),
+    __metadata("design:paramtypes", [Object])
+], MinMaxDto);
+let MultiMinMaxDto = class MultiMinMaxDto {
+    constructor(data) { Object.assign(this, data); }
+};
+MultiMinMaxDto = __decorate([
+    (0, min_less_or_equal_validator_1.MinLessOrEqualMaxProperty)([
+        ['min1', 'max1'],
+        ['min2', 'max2'],
+    ]),
+    __metadata("design:paramtypes", [Object])
+], MultiMinMaxDto);
+describe('MinLessOrEqualMaxProperty', () => {
+    it('passes when one or both are absent', async () => {
+        const dto1 = new MinMaxDto({});
+        const dto2 = new MinMaxDto({ min: 1 });
+        const dto3 = new MinMaxDto({ max: 2 });
+        expect((await (0, class_validator_1.validate)(dto1)).length).toBe(0);
+        expect((await (0, class_validator_1.validate)(dto2)).length).toBe(0);
+        expect((await (0, class_validator_1.validate)(dto3)).length).toBe(0);
+    });
+    it('passes when min <= max', async () => {
+        const dto = new MinMaxDto({ min: 1, max: 1 });
+        const dto2 = new MinMaxDto({ min: 1, max: 2 });
+        expect((await (0, class_validator_1.validate)(dto)).length).toBe(0);
+        expect((await (0, class_validator_1.validate)(dto2)).length).toBe(0);
+    });
+    it('fails when min > max', async () => {
+        const dto = new MinMaxDto({ min: 3, max: 2 });
+        const errors = await (0, class_validator_1.validate)(dto);
+        expect(errors.length).toBeGreaterThan(0);
+    });
+    it('handles multiple pairs correctly', async () => {
+        const ok = new MultiMinMaxDto({ min1: 1, max1: 2, min2: 3, max2: 3 });
+        const errorsOk = await (0, class_validator_1.validate)(ok);
+        expect(errorsOk.length).toBe(0);
+        const bad = new MultiMinMaxDto({ min1: 1, max1: 0, min2: 3, max2: 3 });
+        const errorsBad = await (0, class_validator_1.validate)(bad);
+        expect(errorsBad.length).toBeGreaterThan(0);
+    });
+});

package/dist/decorators/min-less-or-equal.validator.d.ts

@@ -0,0 +1,2 @@
+import { ValidationOptions } from 'class-validator';
+export declare function MinLessOrEqualMaxProperty(keysOrPairs: [string, string] | [string, string][], validationOptions?: ValidationOptions): (constructor: Function) => void;

package/dist/decorators/min-less-or-equal.validator.js

@@ -0,0 +1,58 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MinLessOrEqualMaxProperty = MinLessOrEqualMaxProperty;
+const class_validator_1 = require("class-validator");
+let MinLessOrEqualMaxConstraint = class MinLessOrEqualMaxConstraint {
+    validate(_, args) {
+        const object = args.object;
+        const input = args.constraints[0];
+        const pairs = Array.isArray(input) && typeof input[0] === 'string'
+            ? [input]
+            : input;
+        return pairs.every(([minKey, maxKey]) => {
+            const minVal = object[minKey];
+            const maxVal = object[maxKey];
+            // If one or both are missing, do not fail here; let AllOrNone or other validators handle presence
+            if (minVal === undefined || minVal === null)
+                return true;
+            if (maxVal === undefined || maxVal === null)
+                return true;
+            if (typeof minVal !== 'number' || typeof maxVal !== 'number')
+                return true; // Type guards handled elsewhere
+            return minVal <= maxVal;
+        });
+    }
+    defaultMessage(args) {
+        const input = args.constraints[0];
+        const pairs = Array.isArray(input) && typeof input[0] === 'string'
+            ? [input]
+            : input;
+        if (pairs.length === 1) {
+            const [minKey, maxKey] = pairs[0];
+            return `${minKey} must be less than or equal to ${maxKey}`;
+        }
+        const list = pairs.map(([a, b]) => `${a}<=${b}`).join(', ');
+        return `The following constraints must hold: ${list}`;
+    }
+};
+MinLessOrEqualMaxConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'MinLessOrEqualMax', async: false })
+], MinLessOrEqualMaxConstraint);
+function MinLessOrEqualMaxProperty(keysOrPairs, validationOptions) {
+    return function (constructor) {
+        (0, class_validator_1.registerDecorator)({
+            name: 'MinLessOrEqualMax',
+            target: constructor,
+            propertyName: '',
+            options: validationOptions,
+            constraints: [keysOrPairs],
+            validator: MinLessOrEqualMaxConstraint,
+        });
+    };
+}

package/dist/dtos/action.dto.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActionDto = void 0;
 const class_validator_1 = require("class-validator");
 const open_method_enum_1 = require("../enums/open-method.enum");
+const class_validator_jsonschema_1 = require("class-validator-jsonschema");
 /**
  * Defines the structure for a UI action.
  * @example
@@ -28,20 +29,40 @@ exports.ActionDto = ActionDto;
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Icon',
+        description: 'Name of the icon to display for the action.',
+        type: 'string'
+    }),
     __metadata("design:type", String)
 ], ActionDto.prototype, "icon", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Label',
+        description: 'Text label for the action.',
+        type: 'string'
+    }),
     __metadata("design:type", String)
 ], ActionDto.prototype, "label", void 0);
 __decorate([
     (0, class_validator_1.IsEnum)(open_method_enum_1.OpenMethodEnum),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Open Method',
+        description: 'Method by which the action\'s URL should be opened.',
+        enum: Object.values(open_method_enum_1.OpenMethodEnum)
+    }),
     __metadata("design:type", String)
 ], ActionDto.prototype, "openMethod", void 0);
 __decorate([
     (0, class_validator_1.IsUrl)({ protocols: ['https'], require_protocol: true }),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'URL',
+        description: 'URL to navigate to when the action is triggered.',
+        type: 'string'
+    }),
     __metadata("design:type", String)
 ], ActionDto.prototype, "url", void 0);

package/dist/dtos/admin-panel.dto.js

@@ -20,6 +20,7 @@ const settings_transformer_1 = require("../transformers/settings.transformer");
 const menu_transformer_1 = require("../transformers/menu.transformer");
 const is_one_of_validator_1 = require("../decorators/is-one-of.validator");
 const at_least_one_non_empty_validator_1 = require("../decorators/at-least-one-non-empty.validator");
+const class_validator_jsonschema_1 = require("class-validator-jsonschema");
 let AdminPanelTabsDto = class AdminPanelTabsDto {
 };
 exports.AdminPanelTabsDto = AdminPanelTabsDto;
@@ -29,6 +30,12 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Product Tabs',
+        description: 'Tabs shown on the product detail page in Admin panel.',
+        type: 'array',
+        items: { $ref: '#/components/schemas/TabDto' }
+    }),
     __metadata("design:type", Array)
 ], AdminPanelTabsDto.prototype, "product", void 0);
 __decorate([
@@ -37,6 +44,12 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Item Tabs',
+        description: 'Tabs shown on the item detail page in Admin panel.',
+        type: 'array',
+        items: { $ref: '#/components/schemas/TabDto' }
+    }),
     __metadata("design:type", Array)
 ], AdminPanelTabsDto.prototype, "item", void 0);
 __decorate([
@@ -45,6 +58,12 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Client Tabs',
+        description: 'Tabs shown on the client profile page in Admin panel.',
+        type: 'array',
+        items: { $ref: '#/components/schemas/TabDto' }
+    }),
     __metadata("design:type", Array)
 ], AdminPanelTabsDto.prototype, "client", void 0);
 __decorate([
@@ -53,6 +72,12 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'User Tabs',
+        description: 'Tabs shown on the user page in Admin panel.',
+        type: 'array',
+        items: { $ref: '#/components/schemas/TabDto' }
+    }),
     __metadata("design:type", Array)
 ], AdminPanelTabsDto.prototype, "user", void 0);
 __decorate([
@@ -61,6 +86,12 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Order Tabs',
+        description: 'Tabs shown on the order page in Admin panel.',
+        type: 'array',
+        items: { $ref: '#/components/schemas/TabDto' }
+    }),
     __metadata("design:type", Array)
 ], AdminPanelTabsDto.prototype, "order", void 0);
 exports.AdminPanelTabsDto = AdminPanelTabsDto = __decorate([
@@ -75,6 +106,12 @@ __decorate([
     (0, class_validator_1.ArrayMinSize)(1),
     (0, class_validator_1.ValidateNested)({ each: true }),
     (0, class_transformer_1.Type)(() => action_dto_1.ActionDto),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Client Actions',
+        description: 'Additional actions available on the client page.',
+        type: 'array',
+        items: { $ref: '#/components/schemas/ActionDto' }
+    }),
     __metadata("design:type", Array)
 ], AdminPanelMoreActionsDto.prototype, "client", void 0);
 __decorate([
@@ -83,6 +120,12 @@ __decorate([
     (0, class_validator_1.ArrayMinSize)(1),
     (0, class_validator_1.ValidateNested)({ each: true }),
     (0, class_transformer_1.Type)(() => action_dto_1.ActionDto),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Item Actions',
+        description: 'Additional actions available on the item page.',
+        type: 'array',
+        items: { $ref: '#/components/schemas/ActionDto' }
+    }),
     __metadata("design:type", Array)
 ], AdminPanelMoreActionsDto.prototype, "item", void 0);
 __decorate([
@@ -91,6 +134,12 @@ __decorate([
     (0, class_validator_1.ArrayMinSize)(1),
     (0, class_validator_1.ValidateNested)({ each: true }),
     (0, class_transformer_1.Type)(() => action_dto_1.ActionDto),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Invoice Actions',
+        description: 'Additional actions available on the invoice page.',
+        type: 'array',
+        items: { $ref: '#/components/schemas/ActionDto' }
+    }),
     __metadata("design:type", Array)
 ], AdminPanelMoreActionsDto.prototype, "invoice", void 0);
 __decorate([
@@ -99,6 +148,12 @@ __decorate([
     (0, class_validator_1.ArrayMinSize)(1),
     (0, class_validator_1.ValidateNested)({ each: true }),
     (0, class_transformer_1.Type)(() => action_dto_1.ActionDto),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'User Actions',
+        description: 'Additional actions available on the user page.',
+        type: 'array',
+        items: { $ref: '#/components/schemas/ActionDto' }
+    }),
     __metadata("design:type", Array)
 ], AdminPanelMoreActionsDto.prototype, "user", void 0);
 __decorate([
@@ -107,6 +162,12 @@ __decorate([
     (0, class_validator_1.ArrayMinSize)(1),
     (0, class_validator_1.ValidateNested)({ each: true }),
     (0, class_transformer_1.Type)(() => action_dto_1.ActionDto),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Order Actions',
+        description: 'Additional actions available on the order page.',
+        type: 'array',
+        items: { $ref: '#/components/schemas/ActionDto' }
+    }),
     __metadata("design:type", Array)
 ], AdminPanelMoreActionsDto.prototype, "order", void 0);
 exports.AdminPanelMoreActionsDto = AdminPanelMoreActionsDto = __decorate([
@@ -119,12 +180,24 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.ValidateNested)(),
     (0, class_transformer_1.Type)(() => AdminPanelTabsDto),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Tabs',
+        description: 'Tab structure for Admin panel sections.',
+        type: 'object',
+        properties: { tabs: { $ref: '#/components/schemas/AdminPanelTabsDto' } }
+    }),
     __metadata("design:type", AdminPanelTabsDto)
 ], AdminPanelDto.prototype, "tabs", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.ValidateNested)(),
     (0, class_transformer_1.Type)(() => AdminPanelMoreActionsDto),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'More Actions',
+        description: 'Additional actions in Admin panel sections.',
+        type: 'object',
+        properties: { moreActions: { $ref: '#/components/schemas/AdminPanelMoreActionsDto' } }
+    }),
     __metadata("design:type", AdminPanelMoreActionsDto)
 ], AdminPanelDto.prototype, "moreActions", void 0);
 __decorate([
@@ -134,6 +207,15 @@ __decorate([
     (0, is_one_of_validator_1.IsOneOf)([menu_dto_1.MenuDtoWithUrl, menu_dto_1.MenuDtoWithSubmenu], {
         message: 'menu must be MenuDtoWithUrl or MenuDtoWithSubmenu',
     }),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Menu',
+        description: 'Admin panel main menu (URL or submenu variant).',
+        type: 'object',
+        oneOf: [
+            { $ref: '#/components/schemas/MenuDtoWithSubmenu' },
+            { $ref: '#/components/schemas/MenuDtoWithUrl' }
+        ]
+    }),
     __metadata("design:type", Object)
 ], AdminPanelDto.prototype, "menu", void 0);
 __decorate([
@@ -143,6 +225,15 @@ __decorate([
     (0, is_one_of_validator_1.IsOneOf)([settings_dto_1.SettingsWithUrlDto, settings_dto_1.SettingsWithTabsDto], {
         message: 'settings must be SettingsWithUrlDto or SettingsWithTabsDto',
     }),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Settings',
+        description: 'Admin panel settings page configuration.',
+        type: 'object',
+        oneOf: [
+            { $ref: '#/components/schemas/SettingsWithUrlDto' },
+            { $ref: '#/components/schemas/SettingsWithTabsDto' }
+        ]
+    }),
     __metadata("design:type", Object)
 ], AdminPanelDto.prototype, "settings", void 0);
 exports.AdminPanelDto = AdminPanelDto = __decorate([

package/dist/dtos/client-panel.dto.js

@@ -18,6 +18,7 @@ const tab_dto_1 = require("./tab.dto");
 const menu_transformer_1 = require("../transformers/menu.transformer");
 const is_one_of_validator_1 = require("../decorators/is-one-of.validator");
 const at_least_one_non_empty_validator_1 = require("../decorators/at-least-one-non-empty.validator");
+const class_validator_jsonschema_1 = require("class-validator-jsonschema");
 let ClientPanelTabsDto = class ClientPanelTabsDto {
 };
 exports.ClientPanelTabsDto = ClientPanelTabsDto;
@@ -27,6 +28,12 @@ __decorate([
     (0, class_validator_1.ArrayMinSize)(1),
     (0, class_validator_1.ValidateNested)({ each: true }),
     (0, class_transformer_1.Type)(() => tab_dto_1.TabDto),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Item Tabs',
+        description: 'Tabs shown on the item page in Client panel.',
+        type: 'array',
+        items: { $ref: '#/components/schemas/TabDto' }
+    }),
     __metadata("design:type", Array)
 ], ClientPanelTabsDto.prototype, "item", void 0);
 exports.ClientPanelTabsDto = ClientPanelTabsDto = __decorate([
@@ -41,6 +48,12 @@ __decorate([
     (0, class_validator_1.ArrayMinSize)(1),
     (0, class_validator_1.ValidateNested)({ each: true }),
     (0, class_transformer_1.Type)(() => action_dto_1.ActionDto),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Item Actions',
+        description: 'Additional actions available on the item page in Client panel.',
+        type: 'array',
+        items: { $ref: '#/components/schemas/ActionDto' }
+    }),
     __metadata("design:type", Array)
 ], ClientPanelMoreActionsDto.prototype, "item", void 0);
 exports.ClientPanelMoreActionsDto = ClientPanelMoreActionsDto = __decorate([
@@ -53,12 +66,24 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.ValidateNested)(),
     (0, class_transformer_1.Type)(() => ClientPanelTabsDto),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Tabs',
+        description: 'Tab structure for Client panel.',
+        type: 'object',
+        properties: { tabs: { $ref: '#/components/schemas/ClientPanelTabsDto' } }
+    }),
     __metadata("design:type", ClientPanelTabsDto)
 ], ClientPanelDto.prototype, "tabs", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.ValidateNested)(),
     (0, class_transformer_1.Type)(() => ClientPanelMoreActionsDto),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'More Actions',
+        description: 'Additional actions in Client panel.',
+        type: 'object',
+        properties: { moreActions: { $ref: '#/components/schemas/ClientPanelMoreActionsDto' } }
+    }),
     __metadata("design:type", ClientPanelMoreActionsDto)
 ], ClientPanelDto.prototype, "moreActions", void 0);
 __decorate([
@@ -68,6 +93,11 @@ __decorate([
     (0, is_one_of_validator_1.IsOneOf)([menu_dto_1.MenuDtoWithSubmenu, menu_dto_1.MenuDtoWithUrl], {
         message: 'menu must be either a MenuDtoWithUrl or MenuDtoWithSubmenu',
     }),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Menu',
+        description: 'Client panel main menu (URL or submenu variant).',
+        oneOf: [{ $ref: '#/components/schemas/MenuDtoWithSubmenu' }, { $ref: '#/components/schemas/MenuDtoWithUrl' }],
+    }),
     __metadata("design:type", Object)
 ], ClientPanelDto.prototype, "menu", void 0);
 exports.ClientPanelDto = ClientPanelDto = __decorate([

package/dist/dtos/field-option.dto.js

@@ -11,6 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FieldOptionDto = void 0;
 const class_validator_1 = require("class-validator");
+const class_validator_jsonschema_1 = require("class-validator-jsonschema");
 /**
  * Data Transfer Object for field options.
  * This class defines the structure and properties of a field option
@@ -28,15 +29,30 @@ exports.FieldOptionDto = FieldOptionDto;
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsDefined)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Key',
+        description: 'Internal key for the option.',
+        type: 'string'
+    }),
     __metadata("design:type", String)
 ], FieldOptionDto.prototype, "key", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsDefined)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Value',
+        description: 'Display value for the option.',
+        type: 'string'
+    }),
     __metadata("design:type", String)
 ], FieldOptionDto.prototype, "value", void 0);
 __decorate([
     (0, class_validator_1.IsBoolean)(),
     (0, class_validator_1.IsOptional)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Disabled',
+        description: 'Whether the option is disabled.',
+        type: 'boolean'
+    }),
     __metadata("design:type", Boolean)
 ], FieldOptionDto.prototype, "disabled", void 0);

package/dist/dtos/field.dto.d.ts

@@ -28,6 +28,8 @@ export declare class FieldDto {
      * Type of the field
      */
     type: FieldTypeEnum;
+    reapetableMin?: number;
+    reapetableMax?: number;
     /**
      * Indicates if the field is required
      */