@hosterai/types 0.0.26 → 0.0.28

package/dist/dtos/invoice/responses/tax-details-response.dto.js

@@ -0,0 +1,56 @@
+"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 });
+exports.TaxDetailsResponseDto = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const class_validator_jsonschema_1 = require("class-validator-jsonschema");
+const base_response_dto_1 = require("../../base-response.dto");
+const tin_validation_details_dto_1 = require("../tin-validation-details.dto");
+/**
+ * Represents the response containing tax calculation details.
+ * Includes VAT rate and optional TIN validation information.
+ */
+class TaxDetailsResponseDto extends base_response_dto_1.BaseResponse {
+}
+exports.TaxDetailsResponseDto = TaxDetailsResponseDto;
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'VAT Rate',
+        description: 'The applicable VAT rate for the transaction.',
+        type: 'number',
+    }),
+    __metadata("design:type", Number)
+], TaxDetailsResponseDto.prototype, "vatRate", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'TIN Valid',
+        description: 'Indicates whether the Tax Identification Number is valid.',
+        type: 'boolean',
+    }),
+    __metadata("design:type", Boolean)
+], TaxDetailsResponseDto.prototype, "TINValid", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => tin_validation_details_dto_1.TINValidationDetails),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Tax Details',
+        description: 'Detailed tax validation information including company details.',
+        type: 'object',
+    }),
+    __metadata("design:type", tin_validation_details_dto_1.TINValidationDetails)
+], TaxDetailsResponseDto.prototype, "taxDetails", void 0);

package/dist/dtos/invoice/tin-validation-details.dto.d.ts

@@ -0,0 +1,51 @@
+import { CountryEnum } from '../../enums/country.enum';
+/**
+ * Contains detailed Tax Identification Number validation information.
+ * Includes company details and address information from tax authority validation.
+ */
+export declare class TINValidationDetails {
+    /**
+     * Name of the company as registered with tax authorities
+     */
+    companyName?: string;
+    /**
+     * Primary address line
+     */
+    address1: string;
+    /**
+     * Secondary address line
+     */
+    address2?: string;
+    /**
+     * Tertiary address line
+     */
+    address3?: string;
+    /**
+     * Postal code
+     */
+    postcode: string;
+    /**
+     * City name
+     */
+    city: string;
+    /**
+     * Country code
+     */
+    country: CountryEnum;
+    /**
+     * State or province (if applicable)
+     */
+    state?: string;
+    /**
+     * Tax Identification Number
+     */
+    tin?: string;
+    /**
+     * Tax office name or identifier
+     */
+    taxOffice?: string;
+    /**
+     * List of registered professions or business activities
+     */
+    profession?: string[];
+}

package/dist/dtos/invoice/tin-validation-details.dto.js

@@ -0,0 +1,165 @@
+"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 });
+exports.TINValidationDetails = void 0;
+const class_validator_1 = require("class-validator");
+const country_enum_1 = require("../../enums/country.enum");
+const class_validator_jsonschema_1 = require("class-validator-jsonschema");
+/**
+ * Contains detailed Tax Identification Number validation information.
+ * Includes company details and address information from tax authority validation.
+ */
+class TINValidationDetails {
+}
+exports.TINValidationDetails = TINValidationDetails;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(250),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Company Name',
+        description: 'Name of the company as registered with tax authorities.',
+        type: 'string',
+        minLength: 1,
+        maxLength: 250,
+    }),
+    __metadata("design:type", String)
+], TINValidationDetails.prototype, "companyName", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Address Line 1',
+        description: 'Primary address line.',
+        type: 'string',
+        minLength: 1,
+    }),
+    __metadata("design:type", String)
+], TINValidationDetails.prototype, "address1", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(0),
+    (0, class_validator_1.MaxLength)(250),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Address Line 2',
+        description: 'Secondary address line.',
+        type: 'string',
+        maxLength: 250,
+    }),
+    __metadata("design:type", String)
+], TINValidationDetails.prototype, "address2", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(0),
+    (0, class_validator_1.MaxLength)(250),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Address Line 3',
+        description: 'Tertiary address line.',
+        type: 'string',
+        maxLength: 250,
+    }),
+    __metadata("design:type", String)
+], TINValidationDetails.prototype, "address3", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(16),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Postcode',
+        description: 'Postal code.',
+        type: 'string',
+        minLength: 1,
+        maxLength: 16,
+    }),
+    __metadata("design:type", String)
+], TINValidationDetails.prototype, "postcode", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(250),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'City',
+        description: 'City name.',
+        type: 'string',
+        minLength: 1,
+        maxLength: 250,
+    }),
+    __metadata("design:type", String)
+], TINValidationDetails.prototype, "city", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsEnum)(country_enum_1.CountryEnum),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Country',
+        description: 'Country code.',
+        type: 'string',
+        enum: Object.values(country_enum_1.CountryEnum),
+    }),
+    __metadata("design:type", String)
+], TINValidationDetails.prototype, "country", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(0),
+    (0, class_validator_1.MaxLength)(250),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'State',
+        description: 'State or province.',
+        type: 'string',
+        maxLength: 250,
+    }),
+    __metadata("design:type", String)
+], TINValidationDetails.prototype, "state", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(0),
+    (0, class_validator_1.MaxLength)(20),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'TIN',
+        description: 'Tax Identification Number.',
+        type: 'string',
+        maxLength: 20,
+    }),
+    __metadata("design:type", String)
+], TINValidationDetails.prototype, "tin", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(0),
+    (0, class_validator_1.MaxLength)(250),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Tax Office',
+        description: 'Tax office name or identifier.',
+        type: 'string',
+        maxLength: 250,
+    }),
+    __metadata("design:type", String)
+], TINValidationDetails.prototype, "taxOffice", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(0),
+    (0, class_validator_1.MaxLength)(250),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Profession',
+        description: 'List of registered professions or business activities.',
+        type: 'array',
+        items: { type: 'string' },
+    }),
+    __metadata("design:type", Array)
+], TINValidationDetails.prototype, "profession", void 0);

package/dist/dtos/invoice/transaction-data.dto.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TransactionData = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const class_validator_jsonschema_1 = require("class-validator-jsonschema");
 /**
  * Transaction details related to the invoice.
  * Contains payment and transaction information for the document being issued.
@@ -22,21 +23,42 @@ exports.TransactionData = TransactionData;
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Transaction ID',
+        description: 'Unique identifier for the transaction.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], TransactionData.prototype, "transactionId", void 0);
 __decorate([
     (0, class_validator_1.IsNumber)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Amount',
+        description: 'Transaction amount.',
+        type: 'number',
+    }),
     __metadata("design:type", Number)
 ], TransactionData.prototype, "amount", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Payment Method',
+        description: 'Payment method used for the transaction.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], TransactionData.prototype, "paymentMethod", void 0);
 __decorate([
     (0, class_validator_1.IsDate)(),
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_transformer_1.Type)(() => Date),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Date',
+        description: 'Transaction date.',
+        type: 'string',
+        format: 'date-time',
+    }),
     __metadata("design:type", Date)
 ], TransactionData.prototype, "date", void 0);

package/dist/dtos/invoice-contact-data.dto.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.InvoiceContactData = void 0;
 const class_validator_1 = require("class-validator");
 const country_enum_1 = require("../enums/country.enum");
+const class_validator_jsonschema_1 = require("class-validator-jsonschema");
 /**
  * Billing contact information sent from hoster.ai to invoice integrations.
  * Contains the details of the person or business for whom an invoice will be issued.
@@ -22,41 +23,82 @@ exports.InvoiceContactData = InvoiceContactData;
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Invoice Contact ID',
+        description: 'Unique identifier for the invoice contact.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "invoiceContactId", void 0);
 __decorate([
     (0, class_validator_1.IsBoolean)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Is Business Contact',
+        description: 'Whether this is a business contact or individual person.',
+        type: 'boolean',
+    }),
     __metadata("design:type", Boolean)
 ], InvoiceContactData.prototype, "isBusinessContact", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'First Name',
+        description: 'Contact\'s first name.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "firstName", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Last Name',
+        description: 'Contact\'s last name.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "lastName", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Business Name',
+        description: 'Business name (required when isBusinessContact is true).',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "businessName", void 0);
 __decorate([
     (0, class_validator_1.IsEmail)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Email',
+        description: 'Contact\'s email address.',
+        type: 'string',
+        format: 'email',
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "email", void 0);
 __decorate([
     (0, class_validator_1.IsPhoneNumber)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Telephone',
+        description: 'Primary telephone number in international format.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "telephone", void 0);
 __decorate([
     (0, class_validator_1.IsPhoneNumber)(),
     (0, class_validator_1.IsOptional)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Mobile',
+        description: 'Mobile phone number in international format.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "mobile", void 0);
 __decorate([
@@ -64,18 +106,37 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.MinLength)(1),
     (0, class_validator_1.MaxLength)(250),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Address Line 1',
+        description: 'Primary address line (street, number).',
+        type: 'string',
+        minLength: 1,
+        maxLength: 250,
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "address1", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.MaxLength)(250),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Address Line 2',
+        description: 'Secondary address line (building, floor, apartment).',
+        type: 'string',
+        maxLength: 250,
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "address2", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.MaxLength)(250),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Address Line 3',
+        description: 'Additional address information.',
+        type: 'string',
+        maxLength: 250,
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "address3", void 0);
 __decorate([
@@ -83,6 +144,13 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.MinLength)(1),
     (0, class_validator_1.MaxLength)(16),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Postcode',
+        description: 'Postal/ZIP code.',
+        type: 'string',
+        minLength: 1,
+        maxLength: 16,
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "postcode", void 0);
 __decorate([
@@ -90,31 +158,65 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.MinLength)(1),
     (0, class_validator_1.MaxLength)(250),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'City',
+        description: 'City name.',
+        type: 'string',
+        minLength: 1,
+        maxLength: 250,
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "city", void 0);
 __decorate([
     (0, class_validator_1.IsEnum)(country_enum_1.CountryEnum),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Country',
+        description: 'Country code.',
+        type: 'string',
+        enum: Object.values(country_enum_1.CountryEnum),
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "country", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.MaxLength)(250),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'State',
+        description: 'State/province/region.',
+        type: 'string',
+        maxLength: 250,
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "state", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'TIN',
+        description: 'Tax Identification Number (TIN/VAT number).',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "tin", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Tax Office',
+        description: 'Tax office name or code.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "taxOffice", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Profession',
+        description: 'Contact\'s profession or business activity.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], InvoiceContactData.prototype, "profession", void 0);

package/dist/dtos/item-data.dto.d.ts

@@ -36,9 +36,9 @@ export declare class ItemDataDto {
     /**
      * The price of the product item without tax and discount.
      */
-    price: number;
+    price?: number;
     /**
      * The discount of the product item. The price after removing the discount
      */
-    discountPrice: number;
+    discountPrice?: number;
 }

package/dist/dtos/item-data.dto.js

@@ -11,6 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ItemDataDto = void 0;
 const class_validator_1 = require("class-validator");
+const class_validator_jsonschema_1 = require("class-validator-jsonschema");
 /**
  * Represents the data of a specific product item.
  * This DTO is used to transfer detailed information about a product instance.
@@ -21,50 +22,110 @@ exports.ItemDataDto = ItemDataDto;
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Item ID',
+        description: 'The unique identifier for the product item.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], ItemDataDto.prototype, "itemId", void 0);
 __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Product ID',
+        description: 'Unique identifier for the product.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], ItemDataDto.prototype, "productId", void 0);
 __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Product Name',
+        description: 'Name of the product.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], ItemDataDto.prototype, "productName", void 0);
 __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Resource Name',
+        description: 'Resource name associated with the product.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], ItemDataDto.prototype, "resourceName", void 0);
 __decorate([
     (0, class_validator_1.IsDefined)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Product Attributes',
+        description: 'Product-level attributes defined for the product type.',
+        type: 'object',
+        additionalProperties: true,
+    }),
     __metadata("design:type", Object)
 ], ItemDataDto.prototype, "productAttributes", void 0);
 __decorate([
     (0, class_validator_1.IsDefined)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Item Attributes',
+        description: 'Item-specific attributes unique to this product instance.',
+        type: 'object',
+        additionalProperties: true,
+    }),
     __metadata("design:type", Object)
 ], ItemDataDto.prototype, "itemAttributes", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Creation Response Data',
+        description: 'Data returned from the creation response.',
+        type: 'object',
+        additionalProperties: true,
+    }),
     __metadata("design:type", Object)
 ], ItemDataDto.prototype, "creationResponseData", void 0);
 __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Start Date',
+        description: 'Start date of the product item.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], ItemDataDto.prototype, "startDate", void 0);
 __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'End Date',
+        description: 'End date of the product item.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], ItemDataDto.prototype, "endDate", void 0);
 __decorate([
-    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Price',
+        description: 'The price of the product item without tax and discount.',
+        type: 'number',
+    }),
     __metadata("design:type", Number)
 ], ItemDataDto.prototype, "price", void 0);
 __decorate([
-    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Discount Price',
+        description: 'The price after removing the discount.',
+        type: 'number',
+    }),
     __metadata("design:type", Number)
 ], ItemDataDto.prototype, "discountPrice", void 0);