@hosterai/types 0.0.26 → 0.0.27

package/dist/dtos/country.dto.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CountryDto = 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");
 /**
  * Country information returned by the hoster.ai helper function.
  * Used to provide a list of all available countries.
@@ -22,14 +23,30 @@ exports.CountryDto = CountryDto;
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Name',
+        description: 'Country name.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], CountryDto.prototype, "name", void 0);
 __decorate([
     (0, class_validator_1.IsEnum)(country_enum_1.CountryEnum),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Code',
+        description: 'Country code.',
+        type: 'string',
+        enum: Object.values(country_enum_1.CountryEnum),
+    }),
     __metadata("design:type", String)
 ], CountryDto.prototype, "code", void 0);
 __decorate([
     (0, class_validator_1.IsBoolean)(),
     (0, class_validator_1.IsOptional)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Is Europe',
+        description: 'Whether the country is in Europe.',
+        type: 'boolean',
+    }),
     __metadata("design:type", Boolean)
 ], CountryDto.prototype, "isEurope", void 0);

package/dist/dtos/error-response.dto.js

@@ -11,6 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ErrorResponseDto = void 0;
 const class_validator_1 = require("class-validator");
+const class_validator_jsonschema_1 = require("class-validator-jsonschema");
 /**
  * DTO for error response.
  * Used to return detailed error information to the client.
@@ -21,11 +22,25 @@ exports.ErrorResponseDto = ErrorResponseDto;
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Code',
+        description: 'A unique and specific error code for programmatic error handling.',
+        type: 'number',
+        example: 400,
+    }),
     __metadata("design:type", Number)
 ], ErrorResponseDto.prototype, "code", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Errors',
+        description: 'A developer-friendly error message or an array of messages.',
+        oneOf: [
+            { type: 'string' },
+            { type: 'array', items: { type: 'string' } },
+        ],
+    }),
     __metadata("design:type", Object)
 ], ErrorResponseDto.prototype, "errors", void 0);

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

@@ -31,7 +31,15 @@ export declare class FieldDto {
     /**
      * Indicates if the field is required
      */
-    required: boolean;
+    required?: boolean;
+    /**
+     * Indicates if the field is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Indicates if the field is hidden
+     */
+    hidden?: boolean;
     /**
      * Regex validation pattern for the field
      */
@@ -40,6 +48,14 @@ export declare class FieldDto {
      * Error message for the field for supported languages
      */
     regexValidationErrorMessage?: MultilangTextDto[];
+    /**
+     * Whether remote validation should be triggered
+     */
+    triggersRemoteValidation?: boolean;
+    /**
+     * Remote validation error message for supported languages
+     */
+    remoteValidationErrorMessage?: MultilangTextDto[];
     /**
      * The item attribute is upgradable
      * If the user has the permission to upgrade the item from his panel

package/dist/dtos/field.dto.js

@@ -17,15 +17,13 @@ const field_type_enum_1 = require("../enums/field-type.enum");
 const multilang_text_dto_1 = require("./multilang-text.dto");
 const field_option_dto_1 = require("./field-option.dto");
 const is_regex_validator_1 = require("../decorators/is-regex.validator");
-const all_or_none_validator_1 = require("../decorators/all-or-none.validator");
-const min_less_or_equal_validator_1 = require("../decorators/min-less-or-equal.validator");
 const class_validator_jsonschema_1 = require("class-validator-jsonschema");
 /**
  * Data Transfer Object for a form field.
  * This class defines the structure and properties of a single field
  * that can be used in a user interface form.
  */
-let FieldDto = class FieldDto {
+class FieldDto {
     constructor() {
         /**
          * The item attribute is upgradable
@@ -35,7 +33,7 @@ let FieldDto = class FieldDto {
         this.upgradable = false;
         this.downgradable = false;
     }
-};
+}
 exports.FieldDto = FieldDto;
 __decorate([
     (0, class_validator_1.IsString)(),
@@ -106,6 +104,21 @@ __decorate([
     }),
     __metadata("design:type", Boolean)
 ], FieldDto.prototype, "required", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Disabled',
+        description: 'Whether the field is disabled.',
+        type: 'boolean',
+    }),
+    __metadata("design:type", Boolean)
+], FieldDto.prototype, "disabled", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Boolean)
+], FieldDto.prototype, "hidden", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, is_regex_validator_1.IsRegex)(),
@@ -122,6 +135,8 @@ __decorate([
     (0, class_validator_1.ValidateIf)((o) => !!o.regexValidation),
     (0, class_validator_1.ValidateNested)({ each: true }),
     (0, class_transformer_1.Type)(() => multilang_text_dto_1.MultilangTextDto),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_jsonschema_1.JSONSchema)({
         title: 'Regex Validation Error Message',
@@ -133,7 +148,27 @@ __decorate([
 ], FieldDto.prototype, "regexValidationErrorMessage", void 0);
 __decorate([
     (0, class_validator_1.IsBoolean)(),
-    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Boolean)
+], FieldDto.prototype, "triggersRemoteValidation", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)((o) => !!o.triggersRemoteValidation),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => multilang_text_dto_1.MultilangTextDto),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Remote Validation Error Message',
+        description: 'Localized error message shown when remote validation fails.',
+        type: 'array',
+        items: { $ref: '#/components/schemas/MultilangTextDto' },
+    }),
+    __metadata("design:type", Array)
+], FieldDto.prototype, "remoteValidationErrorMessage", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_jsonschema_1.JSONSchema)({
         title: 'Upgradable',
         description: 'Whether the item attribute is upgradable by the user.',
@@ -143,7 +178,7 @@ __decorate([
 ], FieldDto.prototype, "upgradable", void 0);
 __decorate([
     (0, class_validator_1.IsBoolean)(),
-    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_jsonschema_1.JSONSchema)({
         title: 'Downgradable',
         description: 'Whether the item attribute is downgradable by the user.',
@@ -151,7 +186,3 @@ __decorate([
     }),
     __metadata("design:type", Boolean)
 ], FieldDto.prototype, "downgradable", void 0);
-exports.FieldDto = FieldDto = __decorate([
-    (0, all_or_none_validator_1.AllOrNoneProperty)(['repeatableMin', 'repeatableMax']),
-    (0, min_less_or_equal_validator_1.MinLessOrEqualMaxProperty)(['repeatableMin', 'repeatableMax'])
-], FieldDto);

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

@@ -1,11 +1,9 @@
-import { ProductItemActionsEnum } from '../enums/item-actions.enum';
 import { EventsEnum } from '../enums/events.enum';
 import { LanguageEnum } from '../enums/language.enum';
 import { RolesEnum } from '../enums/roles.enum';
 import { AdminPanelDto } from './admin-panel.dto';
 import { ClientPanelDto } from './client-panel.dto';
 import { FieldDto } from './field.dto';
-import { InvoiceTypesEnum } from '../enums/invoice/invoice-types.enum';
 /**
  * DTO for integration information.
  * This is a central DTO that contains all the necessary information
@@ -32,10 +30,6 @@ export declare class InfoDto {
      * A list of languages supported by the integration.
      */
     supportedLanguages: LanguageEnum[];
-    /**
-     * A list of actions that are supported by this integration.
-     */
-    supportedTypes?: ProductItemActionsEnum[] | InvoiceTypesEnum[];
     /**
      * A list of events that the integration listens to.
      * This allows the integration to react to specific events in the system.

package/dist/dtos/info.dto.js

@@ -10,7 +10,6 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InfoDto = void 0;
-const item_actions_enum_1 = require("../enums/item-actions.enum");
 const events_enum_1 = require("../enums/events.enum");
 const language_enum_1 = require("../enums/language.enum");
 const roles_enum_1 = require("../enums/roles.enum");
@@ -24,7 +23,6 @@ const client_panel_dto_1 = require("./client-panel.dto");
 const class_validator_jsonschema_1 = require("class-validator-jsonschema");
 const field_dto_1 = require("./field.dto");
 const unique_field_in_array_validator_1 = require("../decorators/unique-field-in-array.validator");
-const invoice_types_enum_1 = require("../enums/invoice/invoice-types.enum");
 /**
  * DTO for integration information.
  * This is a central DTO that contains all the necessary information
@@ -32,13 +30,6 @@ const invoice_types_enum_1 = require("../enums/invoice/invoice-types.enum");
  * and billing details.
  */
 class InfoDto {
-    constructor() {
-        /**
-         * A list of actions that are supported by this integration.
-         */
-        //TODO Να φυγει απο εδω 
-        this.supportedTypes = [];
-    }
 }
 exports.InfoDto = InfoDto;
 __decorate([
@@ -89,21 +80,6 @@ __decorate([
     }),
     __metadata("design:type", Array)
 ], InfoDto.prototype, "supportedLanguages", void 0);
-__decorate([
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsArray)(),
-    (0, class_validator_1.IsEnum)(item_actions_enum_1.ProductItemActionsEnum, { each: true }),
-    (0, class_validator_jsonschema_1.JSONSchema)({
-        title: 'Supported Actions',
-        description: 'Actions supported by this integration.',
-        type: 'array',
-        oneOf: [
-            { type: 'string', enum: Object.values(item_actions_enum_1.ProductItemActionsEnum) },
-            { type: 'string', enum: Object.values(invoice_types_enum_1.InvoiceTypesEnum) }
-        ]
-    }),
-    __metadata("design:type", Array)
-], InfoDto.prototype, "supportedTypes", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsArray)(),

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

@@ -11,6 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InvoiceItemDataDto = void 0;
 const class_validator_1 = require("class-validator");
+const class_validator_jsonschema_1 = require("class-validator-jsonschema");
 const invoice_item_actions_enum_1 = require("../../enums/invoice/invoice-item-actions.enum");
 const item_data_dto_1 = require("../item-data.dto");
 /**
@@ -23,5 +24,11 @@ exports.InvoiceItemDataDto = InvoiceItemDataDto;
 __decorate([
     (0, class_validator_1.IsDefined)(),
     (0, class_validator_1.IsEnum)(invoice_item_actions_enum_1.InvoiceItemActionsEnum),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Action',
+        description: 'Invoice-specific action type for this item.',
+        type: 'string',
+        enum: Object.values(invoice_item_actions_enum_1.InvoiceItemActionsEnum),
+    }),
     __metadata("design:type", String)
 ], InvoiceItemDataDto.prototype, "action", void 0);

package/dist/dtos/invoice/requests/credit-note-request.dto.js

@@ -11,6 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreditNoteRequestDto = void 0;
 const class_validator_1 = require("class-validator");
+const class_validator_jsonschema_1 = require("class-validator-jsonschema");
 const proforma_invoice_request_dto_1 = require("./proforma-invoice-request.dto");
 /**
  * Request payload for creating a credit note.
@@ -22,5 +23,10 @@ exports.CreditNoteRequestDto = CreditNoteRequestDto;
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Parent Invoice ID',
+        description: 'Reference to the parent invoice being credited.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], CreditNoteRequestDto.prototype, "parentInvoiceId", void 0);

package/dist/dtos/invoice/requests/invoice-request.dto.js

@@ -11,6 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InvoiceRequestDto = void 0;
 const class_validator_1 = require("class-validator");
+const class_validator_jsonschema_1 = require("class-validator-jsonschema");
 const proforma_invoice_request_dto_1 = require("./proforma-invoice-request.dto");
 /**
  * Request payload for creating a standard invoice.
@@ -22,5 +23,10 @@ exports.InvoiceRequestDto = InvoiceRequestDto;
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Parent Invoice ID',
+        description: 'Reference to parent invoice if applicable.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], InvoiceRequestDto.prototype, "parentInvoiceId", void 0);

package/dist/dtos/invoice/requests/proforma-invoice-request.dto.d.ts

@@ -1,6 +1,7 @@
 import { InvoiceContactData } from "../../invoice-contact-data.dto";
 import { InvoiceItemDataDto } from "../invoice-item-data.dto";
 import { TransactionData } from "../transaction-data.dto";
+import { CountryEnum } from '../../../enums/country.enum';
 /**
  * Request payload for creating a proforma invoice.
  * Sent from hoster.ai to invoice integrations to issue a proforma document.
@@ -10,6 +11,8 @@ export declare class ProformaInvoiceRequestDto {
     invoiceId: string;
     /** Company identifier issuing the invoice */
     companyId: string;
+    /** Country where the company is registered */
+    companyCountry: CountryEnum;
     /** List of transactions associated with this invoice */
     transactions: TransactionData[];
     /** Billing contact information for the invoice recipient */

package/dist/dtos/invoice/requests/proforma-invoice-request.dto.js

@@ -12,9 +12,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProformaInvoiceRequestDto = 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 invoice_contact_data_dto_1 = require("../../invoice-contact-data.dto");
 const invoice_item_data_dto_1 = require("../invoice-item-data.dto");
 const transaction_data_dto_1 = require("../transaction-data.dto");
+const country_enum_1 = require("../../../enums/country.enum");
 /**
  * Request payload for creating a proforma invoice.
  * Sent from hoster.ai to invoice integrations to issue a proforma document.
@@ -23,34 +25,80 @@ class ProformaInvoiceRequestDto {
 }
 exports.ProformaInvoiceRequestDto = ProformaInvoiceRequestDto;
 __decorate([
+    (0, class_validator_1.IsDefined)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Invoice ID',
+        description: 'Unique identifier for the invoice.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], ProformaInvoiceRequestDto.prototype, "invoiceId", void 0);
 __decorate([
+    (0, class_validator_1.IsDefined)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Company ID',
+        description: 'Company identifier issuing the invoice.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], ProformaInvoiceRequestDto.prototype, "companyId", void 0);
 __decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsEnum)(country_enum_1.CountryEnum),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Company Country',
+        description: 'Country where the company is registered.',
+        type: 'string',
+        enum: Object.values(country_enum_1.CountryEnum),
+    }),
+    __metadata("design:type", String)
+], ProformaInvoiceRequestDto.prototype, "companyCountry", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)(),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ValidateNested)({ each: true }),
     (0, class_transformer_1.Type)(() => transaction_data_dto_1.TransactionData),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Transactions',
+        description: 'List of transactions associated with this invoice.',
+        type: 'array',
+        items: { $ref: '#/components/schemas/TransactionData' },
+    }),
     __metadata("design:type", Array)
 ], ProformaInvoiceRequestDto.prototype, "transactions", void 0);
 __decorate([
+    (0, class_validator_1.IsDefined)(),
     (0, class_validator_1.ValidateNested)(),
     (0, class_transformer_1.Type)(() => invoice_contact_data_dto_1.InvoiceContactData),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Invoice Contact',
+        description: 'Billing contact information for the invoice recipient.',
+        $ref: '#/components/schemas/InvoiceContactData',
+    }),
     __metadata("design:type", invoice_contact_data_dto_1.InvoiceContactData)
 ], ProformaInvoiceRequestDto.prototype, "invoiceContact", void 0);
 __decorate([
+    (0, class_validator_1.IsDefined)(),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ValidateNested)({ each: true }),
     (0, class_transformer_1.Type)(() => invoice_item_data_dto_1.InvoiceItemDataDto),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Items',
+        description: 'Line items included in the invoice.',
+        type: 'array',
+        items: { $ref: '#/components/schemas/InvoiceItemDataDto' },
+    }),
     __metadata("design:type", Array)
 ], ProformaInvoiceRequestDto.prototype, "items", void 0);
 __decorate([
+    (0, class_validator_1.IsDefined)(),
     (0, class_validator_1.IsNumber)(),
-    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Total Amount',
+        description: 'Total invoice amount.',
+        type: 'number',
+    }),
     __metadata("design:type", Number)
 ], ProformaInvoiceRequestDto.prototype, "totalAmount", void 0);

package/dist/dtos/invoice/requests/tax-details-request.dto.d.ts

@@ -0,0 +1,31 @@
+import { CountryEnum } from '../../../enums/country.enum';
+/**
+ * Request payload for calculating tax details.
+ * Contains company and customer location information for tax rate determination.
+ */
+export declare class TaxDetailsRequestDto {
+    /**
+     * Country where the company is registered
+     */
+    companyCountry: CountryEnum;
+    /**
+     * Country where the customer is located
+     */
+    customerCountry: CountryEnum;
+    /**
+     * Customer's Tax Identification Number
+     */
+    customerTIN: string;
+    /**
+     * Customer's postal code
+     */
+    customerPostalCode?: string;
+    /**
+     * Customer's state or province
+     */
+    customerState?: string;
+    /**
+     * Indicates whether the customer address has been validated
+     */
+    validatedAddress?: boolean;
+}

package/dist/dtos/invoice/requests/tax-details-request.dto.js

@@ -0,0 +1,84 @@
+"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.TaxDetailsRequestDto = 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");
+/**
+ * Request payload for calculating tax details.
+ * Contains company and customer location information for tax rate determination.
+ */
+class TaxDetailsRequestDto {
+}
+exports.TaxDetailsRequestDto = TaxDetailsRequestDto;
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsEnum)(country_enum_1.CountryEnum),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Company Country',
+        description: 'Country where the company is registered.',
+        type: 'string',
+        enum: Object.values(country_enum_1.CountryEnum),
+    }),
+    __metadata("design:type", String)
+], TaxDetailsRequestDto.prototype, "companyCountry", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsEnum)(country_enum_1.CountryEnum),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Customer Country',
+        description: 'Country where the customer is located.',
+        type: 'string',
+        enum: Object.values(country_enum_1.CountryEnum),
+    }),
+    __metadata("design:type", String)
+], TaxDetailsRequestDto.prototype, "customerCountry", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Customer TIN',
+        description: 'Customer\'s Tax Identification Number.',
+        type: 'string',
+    }),
+    __metadata("design:type", String)
+], TaxDetailsRequestDto.prototype, "customerTIN", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Customer Postal Code',
+        description: 'Customer\'s postal code.',
+        type: 'string',
+    }),
+    __metadata("design:type", String)
+], TaxDetailsRequestDto.prototype, "customerPostalCode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Customer State',
+        description: 'Customer\'s state or province.',
+        type: 'string',
+    }),
+    __metadata("design:type", String)
+], TaxDetailsRequestDto.prototype, "customerState", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Validated Address',
+        description: 'Whether the customer address has been validated.',
+        type: 'boolean',
+    }),
+    __metadata("design:type", Boolean)
+], TaxDetailsRequestDto.prototype, "validatedAddress", void 0);

package/dist/dtos/invoice/responses/proforma-invoice-response.dto.js

@@ -11,6 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProformaInvoiceResponseDto = void 0;
 const class_validator_1 = require("class-validator");
+const class_validator_jsonschema_1 = require("class-validator-jsonschema");
 /**
  * Response from invoice integrations after successfully creating a proforma invoice.
  * Contains the generated invoice details and access URL.
@@ -21,15 +22,31 @@ exports.ProformaInvoiceResponseDto = ProformaInvoiceResponseDto;
 __decorate([
     (0, class_validator_1.IsUrl)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Invoice URL',
+        description: 'URL to access the generated invoice document.',
+        type: 'string',
+        format: 'uri',
+    }),
     __metadata("design:type", String)
 ], ProformaInvoiceResponseDto.prototype, "invoiceUrl", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Invoice Number',
+        description: 'Invoice number assigned by the integration.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], ProformaInvoiceResponseDto.prototype, "invoiceNumber", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_jsonschema_1.JSONSchema)({
+        title: 'Invoice ID',
+        description: 'Unique identifier for the invoice in the integration system.',
+        type: 'string',
+    }),
     __metadata("design:type", String)
 ], ProformaInvoiceResponseDto.prototype, "invoiceId", void 0);

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

@@ -0,0 +1,20 @@
+import { BaseResponse } from '../../base-response.dto';
+import { TINValidationDetails } from '../tin-validation-details.dto';
+/**
+ * Represents the response containing tax calculation details.
+ * Includes VAT rate and optional TIN validation information.
+ */
+export declare class TaxDetailsResponseDto extends BaseResponse {
+    /**
+     * The applicable VAT rate for the transaction
+     */
+    vatRate: number;
+    /**
+     * Indicates whether the Tax Identification Number is valid
+     */
+    TINValid?: boolean;
+    /**
+     * Detailed tax validation information including company details
+     */
+    taxDetails?: TINValidationDetails;
+}