qeai-sdk 2.0.0 → 2.0.2

package/dist/constants/index.d.ts

@@ -15,15 +15,17 @@
  *
  * @since 2.0.0
  */
-export * from './auth-commands.constant';
-export * from './category-commands.constant';
-export * from './chain-commands.constant';
-export * from './ingredient-commands.constant';
-export * from './order-commands.constant';
-export * from './payment-commands.constant';
-export * from './payment-events.constant';
-export * from './product-commands.constant';
-export * from './product-events.constant';
-export * from './question-commands.constant';
-export * from './restaurant-commands.constant';
-export * from './tag-commands.constant';
+export * from './auth-commands.constant.js';
+export * from './category-commands.constant.js';
+export * from './chain-commands.constant.js';
+export * from './ingredient-commands.constant.js';
+export * from './order-commands.constant.js';
+export * from './payment-commands.constant.js';
+export * from './payment-events.constant.js';
+export * from './product-commands.constant.js';
+export * from './product-events.constant.js';
+export * from './question-commands.constant.js';
+export * from './restaurant-commands.constant.js';
+export * from './tag-commands.constant.js';
+export * from './translation-commands.constant.js';
+export * from './services-config.constant.js';

package/dist/constants/index.js

@@ -16,24 +16,28 @@
  * @since 2.0.0
  */
 // Auth commands
-export * from './auth-commands.constant';
+export * from './auth-commands.constant.js';
 // Category commands
-export * from './category-commands.constant';
+export * from './category-commands.constant.js';
 // Chain commands
-export * from './chain-commands.constant';
+export * from './chain-commands.constant.js';
 // Ingredient commands
-export * from './ingredient-commands.constant';
+export * from './ingredient-commands.constant.js';
 // Order commands
-export * from './order-commands.constant';
+export * from './order-commands.constant.js';
 // Payment commands and events
-export * from './payment-commands.constant';
-export * from './payment-events.constant';
+export * from './payment-commands.constant.js';
+export * from './payment-events.constant.js';
 // Product commands and events
-export * from './product-commands.constant';
-export * from './product-events.constant';
+export * from './product-commands.constant.js';
+export * from './product-events.constant.js';
 // Question commands
-export * from './question-commands.constant';
+export * from './question-commands.constant.js';
 // Restaurant commands
-export * from './restaurant-commands.constant';
+export * from './restaurant-commands.constant.js';
 // Tag commands
-export * from './tag-commands.constant';
+export * from './tag-commands.constant.js';
+// Translation commands
+export * from './translation-commands.constant.js';
+// Services config
+export * from './services-config.constant.js';

package/dist/constants/product-commands.constant.d.ts

@@ -88,10 +88,16 @@ export declare const PRODUCT_COMMANDS: {
     readonly IMAGE_REMOVE: "product-image.remove";
     /** Remove all images for a product */
     readonly IMAGE_REMOVE_BY_PRODUCT: "product-image.remove-by-product-id";
+    /** Bulk create images for a product */
+    readonly IMAGE_BULK_CREATE: "product-image.bulk-create";
+    /** Set primary image for a product */
+    readonly IMAGE_SET_PRIMARY: "product-image.set-primary";
     /** Create a new question for a product */
     readonly QUESTION_CREATE: "product-question.create";
     /** Retrieve all questions for a product */
     readonly QUESTION_FIND_BY_PRODUCT: "product-question.find-by-product-id";
+    /** Retrieve questions for a product filtered by type */
+    readonly QUESTION_FIND_BY_PRODUCT_AND_TYPE: "product-question.find-by-product-id-and-type";
     /** Retrieve specific product question by ID */
     readonly QUESTION_FIND_ONE: "product-question.find-one";
     /** Replace all questions for a product */

package/dist/constants/product-commands.constant.js

@@ -93,11 +93,17 @@ export const PRODUCT_COMMANDS = {
     IMAGE_REMOVE: 'product-image.remove',
     /** Remove all images for a product */
     IMAGE_REMOVE_BY_PRODUCT: 'product-image.remove-by-product-id',
+    /** Bulk create images for a product */
+    IMAGE_BULK_CREATE: 'product-image.bulk-create',
+    /** Set primary image for a product */
+    IMAGE_SET_PRIMARY: 'product-image.set-primary',
     // === ProductQuestion ===
     /** Create a new question for a product */
     QUESTION_CREATE: 'product-question.create',
     /** Retrieve all questions for a product */
     QUESTION_FIND_BY_PRODUCT: 'product-question.find-by-product-id',
+    /** Retrieve questions for a product filtered by type */
+    QUESTION_FIND_BY_PRODUCT_AND_TYPE: 'product-question.find-by-product-id-and-type',
     /** Retrieve specific product question by ID */
     QUESTION_FIND_ONE: 'product-question.find-one',
     /** Replace all questions for a product */

package/dist/constants/services-config.constant.d.ts

@@ -0,0 +1,3 @@
+export declare const SERVICES: {
+    NATS_SERVICE: string;
+};

package/dist/constants/services-config.constant.js

@@ -0,0 +1 @@
+export const SERVICES = { NATS_SERVICE: "NATS_SERVICE" };

package/dist/constants/translation-commands.constant.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Translation service command subjects.
+ *
+ * Centralized constant containing all subject/message keys
+ * for commands between client(s) and the Translation microservice.
+ * Each key corresponds to a MessagePattern used for inter-service communication
+ * regarding translation management.
+ *
+ * Naming convention:
+ *  - Keys use SCREAMING_SNAKE_CASE.
+ *  - Subject values use kebab-case between dots, matching the entity domain ('translation').
+ *
+ * Usage examples:
+ *    - TRANSLATION_COMMANDS.CREATE: Subject for creating a translation.
+ *    - TRANSLATION_COMMANDS.FIND_ALL_BY_ENTITY: Subject for retrieving translations by entity.
+ *    - TRANSLATION_COMMANDS.FIND_ONE: Subject for fetching a specific translation by ID.
+ *    - TRANSLATION_COMMANDS.UPDATE: Subject for updating a translation.
+ *    - TRANSLATION_COMMANDS.DELETE: Subject for soft deleting a translation.
+ *
+ * Centralizing these keys ensures consistency, discoverability, and maintainability.
+ *
+ * @since 2.0.0
+ */
+export declare const TRANSLATION_COMMANDS: {
+    /** Create a new translation */
+    readonly CREATE: "translation.create";
+    /** Retrieve all translations for a specific entity */
+    readonly FIND_ALL_BY_ENTITY: "translation.find-all-by-entity";
+    /** Retrieve a specific translation by ID */
+    readonly FIND_ONE: "translation.find-one";
+    /** Update an existing translation */
+    readonly UPDATE: "translation.update";
+    /** Soft delete a translation by ID */
+    readonly DELETE: "translation.delete";
+};

package/dist/constants/translation-commands.constant.js

@@ -0,0 +1,35 @@
+/**
+ * Translation service command subjects.
+ *
+ * Centralized constant containing all subject/message keys
+ * for commands between client(s) and the Translation microservice.
+ * Each key corresponds to a MessagePattern used for inter-service communication
+ * regarding translation management.
+ *
+ * Naming convention:
+ *  - Keys use SCREAMING_SNAKE_CASE.
+ *  - Subject values use kebab-case between dots, matching the entity domain ('translation').
+ *
+ * Usage examples:
+ *    - TRANSLATION_COMMANDS.CREATE: Subject for creating a translation.
+ *    - TRANSLATION_COMMANDS.FIND_ALL_BY_ENTITY: Subject for retrieving translations by entity.
+ *    - TRANSLATION_COMMANDS.FIND_ONE: Subject for fetching a specific translation by ID.
+ *    - TRANSLATION_COMMANDS.UPDATE: Subject for updating a translation.
+ *    - TRANSLATION_COMMANDS.DELETE: Subject for soft deleting a translation.
+ *
+ * Centralizing these keys ensures consistency, discoverability, and maintainability.
+ *
+ * @since 2.0.0
+ */
+export const TRANSLATION_COMMANDS = {
+    /** Create a new translation */
+    CREATE: 'translation.create',
+    /** Retrieve all translations for a specific entity */
+    FIND_ALL_BY_ENTITY: 'translation.find-all-by-entity',
+    /** Retrieve a specific translation by ID */
+    FIND_ONE: 'translation.find-one',
+    /** Update an existing translation */
+    UPDATE: 'translation.update',
+    /** Soft delete a translation by ID */
+    DELETE: 'translation.delete',
+};

package/dist/dtos/auth/index.d.ts

@@ -6,5 +6,5 @@
  *
  * @since 2.0.0
  */
-export * from './login-user.dto';
-export * from './register-user.dto';
+export * from './login-user.dto.js';
+export * from './register-user.dto.js';

package/dist/dtos/auth/index.js

@@ -6,5 +6,5 @@
  *
  * @since 2.0.0
  */
-export * from './login-user.dto';
-export * from './register-user.dto';
+export * from './login-user.dto.js';
+export * from './register-user.dto.js';

package/dist/dtos/auth/register-user.dto.js

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { IsEmail, IsString, IsStrongPassword } from 'class-validator';
+import { IsEmail, IsNotEmpty, IsString, IsStrongPassword, MinLength } from 'class-validator';
 /**
  * DTO for user registration requests.
  *
@@ -40,6 +40,8 @@ export class RegisterUserDto {
 }
 __decorate([
     IsString(),
+    IsNotEmpty(),
+    MinLength(3),
     __metadata("design:type", String)
 ], RegisterUserDto.prototype, "name", void 0);
 __decorate([
@@ -48,6 +50,7 @@ __decorate([
     __metadata("design:type", String)
 ], RegisterUserDto.prototype, "email", void 0);
 __decorate([
+    IsNotEmpty(),
     IsString(),
     IsStrongPassword({
         minLength: 8,

package/dist/dtos/categories/create-category.dto.js

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { IsString, IsOptional, IsBoolean, IsMongoId, IsNotEmpty } from 'class-validator';
+import { IsString, IsOptional, IsBoolean, IsNotEmpty, MinLength, MaxLength, IsUUID } from 'class-validator';
 /**
  * DTO for creating a new category.
  *
@@ -49,11 +49,14 @@ export class CreateCategoryDto {
 __decorate([
     IsString(),
     IsNotEmpty({ message: 'Category name is required' }),
+    MinLength(3),
     __metadata("design:type", String)
 ], CreateCategoryDto.prototype, "name", void 0);
 __decorate([
     IsOptional(),
     IsString(),
+    MinLength(10),
+    MaxLength(200),
     __metadata("design:type", String)
 ], CreateCategoryDto.prototype, "description", void 0);
 __decorate([
@@ -62,8 +65,8 @@ __decorate([
     __metadata("design:type", Boolean)
 ], CreateCategoryDto.prototype, "status", void 0);
 __decorate([
-    IsOptional(),
     IsString(),
-    IsMongoId(),
+    IsUUID(),
+    IsNotEmpty(),
     __metadata("design:type", String)
 ], CreateCategoryDto.prototype, "createdBy", void 0);

package/dist/dtos/categories/delete-category.dto.d.ts

@@ -13,7 +13,7 @@ export declare class DeleteCategoryDto {
      *
      * @example "550e8400-e29b-41d4-a716-446655440000"
      */
-    id: string;
+    categoryId: string;
     /**
      * User who deleted the category.
      * Must be a valid MongoDB ObjectId.

package/dist/dtos/categories/delete-category.dto.js

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { IsString, IsMongoId, IsUUID } from 'class-validator';
+import { IsString, IsMongoId, IsUUID, IsNotEmpty } from 'class-validator';
 /**
  * DTO for deleting a category.
  *
@@ -23,7 +23,7 @@ export class DeleteCategoryDto {
      *
      * @example "550e8400-e29b-41d4-a716-446655440000"
      */
-    id;
+    categoryId;
     /**
      * User who deleted the category.
      * Must be a valid MongoDB ObjectId.
@@ -35,10 +35,12 @@ export class DeleteCategoryDto {
 __decorate([
     IsString(),
     IsUUID(),
+    IsNotEmpty(),
     __metadata("design:type", String)
-], DeleteCategoryDto.prototype, "id", void 0);
+], DeleteCategoryDto.prototype, "categoryId", void 0);
 __decorate([
     IsString(),
     IsMongoId(),
+    IsNotEmpty(),
     __metadata("design:type", String)
 ], DeleteCategoryDto.prototype, "deletedBy", void 0);

package/dist/dtos/categories/index.d.ts

@@ -6,6 +6,6 @@
  *
  * @since 2.0.0
  */
-export * from './create-category.dto';
-export * from './update-category.dto';
-export * from './delete-category.dto';
+export * from './create-category.dto.js';
+export * from './update-category.dto.js';
+export * from './delete-category.dto.js';

package/dist/dtos/categories/index.js

@@ -6,6 +6,6 @@
  *
  * @since 2.0.0
  */
-export * from './create-category.dto';
-export * from './update-category.dto';
-export * from './delete-category.dto';
+export * from './create-category.dto.js';
+export * from './update-category.dto.js';
+export * from './delete-category.dto.js';

package/dist/dtos/categories/update-category.dto.d.ts

@@ -1,26 +1,45 @@
-declare const UpdateCategoryDto_base: import("@nestjs/mapped-types").MappedType<Partial<unknown>>;
 /**
  * DTO for updating an existing category.
  *
- * Extends CreateCategoryDto with all fields optional.
- * Used by the Products microservice to update category details.
+ * Allows partial updates of category details. All fields except `categoryId` and `updatedBy` are optional,
+ * permitting fine-grained modifications. Used by the Products microservice to apply changes to product categories.
  *
  * @since 2.0.0
  */
-export declare class UpdateCategoryDto extends UpdateCategoryDto_base {
+export declare class UpdateCategoryDto {
     /**
-     * Category ID to update.
-     * Must be a valid UUID.
+     * Category name.
+     * Optional. If provided, must be a string.
+     *
+     * @example "Beverages"
+     */
+    name?: string;
+    /**
+     * Category description.
+     * Optional. If provided, must be a string.
+     *
+     * @example "All types of drinks and beverages"
+     */
+    description?: string;
+    /**
+     * Category status (active/inactive).
+     * Optional. If provided, must be a boolean.
+     *
+     * @example true
+     */
+    status?: boolean;
+    /**
+     * Unique identifier of the category to update.
+     * Required. Must be a valid UUID string.
      *
      * @example "550e8400-e29b-41d4-a716-446655440000"
      */
-    id?: string;
+    categoryId: string;
     /**
-     * User who updated the category.
-     * Must be a valid MongoDB ObjectId if provided.
+     * Unique identifier of the user performing the update.
+     * Required. Must be a valid MongoDB ObjectId.
      *
      * @example "507f1f77bcf86cd799439011"
      */
-    updatedBy?: string;
+    updatedBy: string;
 }
-export {};

package/dist/dtos/categories/update-category.dto.js

@@ -7,42 +7,76 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { PartialType } from '@nestjs/mapped-types';
-import { IsString, IsOptional, IsMongoId, IsUUID } from 'class-validator';
-import { CreateCategoryDto } from './create-category.dto';
+import { IsString, IsOptional, IsMongoId, IsUUID, IsBoolean, IsNotEmpty } from 'class-validator';
 /**
  * DTO for updating an existing category.
  *
- * Extends CreateCategoryDto with all fields optional.
- * Used by the Products microservice to update category details.
+ * Allows partial updates of category details. All fields except `categoryId` and `updatedBy` are optional,
+ * permitting fine-grained modifications. Used by the Products microservice to apply changes to product categories.
  *
  * @since 2.0.0
  */
-export class UpdateCategoryDto extends PartialType(CreateCategoryDto) {
+export class UpdateCategoryDto {
     /**
-     * Category ID to update.
-     * Must be a valid UUID.
+     * Category name.
+     * Optional. If provided, must be a string.
+     *
+     * @example "Beverages"
+     */
+    name;
+    /**
+     * Category description.
+     * Optional. If provided, must be a string.
+     *
+     * @example "All types of drinks and beverages"
+     */
+    description;
+    /**
+     * Category status (active/inactive).
+     * Optional. If provided, must be a boolean.
+     *
+     * @example true
+     */
+    status;
+    /**
+     * Unique identifier of the category to update.
+     * Required. Must be a valid UUID string.
      *
      * @example "550e8400-e29b-41d4-a716-446655440000"
      */
-    id;
+    categoryId;
     /**
-     * User who updated the category.
-     * Must be a valid MongoDB ObjectId if provided.
+     * Unique identifier of the user performing the update.
+     * Required. Must be a valid MongoDB ObjectId.
      *
      * @example "507f1f77bcf86cd799439011"
      */
     updatedBy;
 }
 __decorate([
+    IsOptional(),
     IsString(),
-    IsUUID(),
+    __metadata("design:type", String)
+], UpdateCategoryDto.prototype, "name", void 0);
+__decorate([
+    IsOptional(),
+    IsString(),
+    __metadata("design:type", String)
+], UpdateCategoryDto.prototype, "description", void 0);
+__decorate([
     IsOptional(),
+    IsBoolean(),
+    __metadata("design:type", Boolean)
+], UpdateCategoryDto.prototype, "status", void 0);
+__decorate([
+    IsString(),
+    IsUUID(),
+    IsNotEmpty({ message: 'categoryId is required and must be a valid UUID.' }),
     __metadata("design:type", String)
-], UpdateCategoryDto.prototype, "id", void 0);
+], UpdateCategoryDto.prototype, "categoryId", void 0);
 __decorate([
     IsString(),
     IsMongoId(),
-    IsOptional(),
+    IsNotEmpty({ message: 'updatedBy is required and must be a valid MongoId.' }),
     __metadata("design:type", String)
 ], UpdateCategoryDto.prototype, "updatedBy", void 0);

package/dist/dtos/chain/create-chain.dto.d.ts

@@ -1,43 +1,42 @@
-import { Currency } from '../../enums/currency.enum';
+import { Currency } from '../../enums/currency.enum.js';
 /**
  * DTO for creating a new chain.
  *
  * Used by the Products microservice to create new restaurant chains.
- * Chains represent restaurant brands that can have multiple locations.
+ * Chains represent restaurant brands that may operate multiple locations.
  *
  * @since 2.0.0
  */
 export declare class CreateChainDto {
     /**
-     * Chain name.
-     * Must not be empty.
+     * Name of the chain.
+     * Required. Must be a string of at least 3 characters.
      *
      * @example "McDonald's"
      */
     name: string;
     /**
-     * Chain currency code.
-     * Must be a valid Currency enum value.
-     * Defaults to PEN if not provided.
+     * Currency to be used by the entire chain.
+     * Optional. If provided, must be a valid currency code defined in the Currency enum.
+     * Defaults to PEN.
      *
      * @example Currency.PEN
      * @default Currency.PEN
      */
     currency?: Currency;
     /**
-     * Global tax percentage for the chain.
-     * Must be between 0 and 100 if provided.
-     * Defaults to 0 if not provided.
+     * Global tax percentage to apply across the whole chain.
+     * Optional. Must be a number between 0 and 100. Defaults to 0.0 (no tax).
      *
      * @example 8.5
      * @default 0.0
      */
     taxPercent?: number;
     /**
-     * User who created the chain.
-     * Must be a valid MongoDB ObjectId if provided.
+     * Unique identifier of the user who is creating the chain.
+     * Required. Must be a valid MongoDB ObjectId.
      *
      * @example "507f1f77bcf86cd799439011"
      */
-    createdBy?: string;
+    createdBy: string;
 }

package/dist/dtos/chain/create-chain.dto.js

@@ -7,45 +7,44 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { IsString, IsOptional, IsNumber, Min, Max, IsEnum, IsMongoId } from 'class-validator';
-import { Currency } from '../../enums/currency.enum';
+import { IsString, IsOptional, IsNumber, Min, Max, IsEnum, IsMongoId, IsNotEmpty, MinLength } from 'class-validator';
+import { Currency } from '../../enums/currency.enum.js';
 /**
  * DTO for creating a new chain.
  *
  * Used by the Products microservice to create new restaurant chains.
- * Chains represent restaurant brands that can have multiple locations.
+ * Chains represent restaurant brands that may operate multiple locations.
  *
  * @since 2.0.0
  */
 export class CreateChainDto {
     /**
-     * Chain name.
-     * Must not be empty.
+     * Name of the chain.
+     * Required. Must be a string of at least 3 characters.
      *
      * @example "McDonald's"
      */
     name;
     /**
-     * Chain currency code.
-     * Must be a valid Currency enum value.
-     * Defaults to PEN if not provided.
+     * Currency to be used by the entire chain.
+     * Optional. If provided, must be a valid currency code defined in the Currency enum.
+     * Defaults to PEN.
      *
      * @example Currency.PEN
      * @default Currency.PEN
      */
     currency = Currency.PEN;
     /**
-     * Global tax percentage for the chain.
-     * Must be between 0 and 100 if provided.
-     * Defaults to 0 if not provided.
+     * Global tax percentage to apply across the whole chain.
+     * Optional. Must be a number between 0 and 100. Defaults to 0.0 (no tax).
      *
      * @example 8.5
      * @default 0.0
      */
     taxPercent = 0.0;
     /**
-     * User who created the chain.
-     * Must be a valid MongoDB ObjectId if provided.
+     * Unique identifier of the user who is creating the chain.
+     * Required. Must be a valid MongoDB ObjectId.
      *
      * @example "507f1f77bcf86cd799439011"
      */
@@ -53,6 +52,8 @@ export class CreateChainDto {
 }
 __decorate([
     IsString(),
+    IsNotEmpty({ message: 'Chain name is required' }),
+    MinLength(3),
     __metadata("design:type", String)
 ], CreateChainDto.prototype, "name", void 0);
 __decorate([
@@ -68,8 +69,8 @@ __decorate([
     __metadata("design:type", Number)
 ], CreateChainDto.prototype, "taxPercent", void 0);
 __decorate([
-    IsOptional(),
     IsString(),
-    IsMongoId(),
+    IsMongoId({ message: 'createdBy must be a valid MongoDB ObjectId' }),
+    IsNotEmpty({ message: 'createdBy is required and must be a valid MongoDB ObjectId' }),
     __metadata("design:type", String)
 ], CreateChainDto.prototype, "createdBy", void 0);

package/dist/dtos/chain/delete-chain.dto.d.ts

@@ -2,21 +2,21 @@
  * DTO for deleting a chain.
  *
  * Used by the Products microservice to soft-delete chains.
- * Includes chain ID and user who performed the deletion.
+ * Holds the chain unique identifier and the user who performed the deletion.
  *
  * @since 2.0.0
  */
 export declare class DeleteChainDto {
     /**
-     * Chain ID to delete.
-     * Must be a valid UUID.
+     * Unique identifier of the chain to delete.
+     * Required. Must be a valid UUID format.
      *
      * @example "550e8400-e29b-41d4-a716-446655440000"
      */
-    id: string;
+    chainId: string;
     /**
-     * User who deleted the chain.
-     * Must be a valid MongoDB ObjectId.
+     * Unique identifier of the user performing the deletion.
+     * Required. Must be a valid MongoDB ObjectId.
      *
      * @example "507f1f77bcf86cd799439011"
      */