qeai-sdk 2.0.0

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

@@ -0,0 +1,69 @@
+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);
+};
+import { IsString, IsOptional, IsBoolean, IsMongoId, IsNotEmpty } from 'class-validator';
+/**
+ * DTO for creating a new category.
+ *
+ * Used by the Products microservice to create new product categories.
+ * Categories organize products and help customers navigate the menu.
+ *
+ * @since 2.0.0
+ */
+export class CreateCategoryDto {
+    /**
+     * Category name.
+     * Must not be empty.
+     *
+     * @example "Beverages"
+     */
+    name;
+    /**
+     * Optional category description.
+     *
+     * @example "All types of drinks and beverages"
+     */
+    description;
+    /**
+     * Category status (active/inactive).
+     * Defaults to true if not provided.
+     *
+     * @example true
+     * @default true
+     */
+    status = true;
+    /**
+     * User who created the category.
+     * Must be a valid MongoDB ObjectId.
+     *
+     * @example "507f1f77bcf86cd799439011"
+     */
+    createdBy;
+}
+__decorate([
+    IsString(),
+    IsNotEmpty({ message: 'Category name is required' }),
+    __metadata("design:type", String)
+], CreateCategoryDto.prototype, "name", void 0);
+__decorate([
+    IsOptional(),
+    IsString(),
+    __metadata("design:type", String)
+], CreateCategoryDto.prototype, "description", void 0);
+__decorate([
+    IsOptional(),
+    IsBoolean(),
+    __metadata("design:type", Boolean)
+], CreateCategoryDto.prototype, "status", void 0);
+__decorate([
+    IsOptional(),
+    IsString(),
+    IsMongoId(),
+    __metadata("design:type", String)
+], CreateCategoryDto.prototype, "createdBy", void 0);

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

@@ -0,0 +1,24 @@
+/**
+ * DTO for deleting a category.
+ *
+ * Used by the Products microservice to soft-delete categories.
+ * Includes category ID and user who performed the deletion.
+ *
+ * @since 2.0.0
+ */
+export declare class DeleteCategoryDto {
+    /**
+     * Category ID to delete.
+     * Must be a valid UUID.
+     *
+     * @example "550e8400-e29b-41d4-a716-446655440000"
+     */
+    id: string;
+    /**
+     * User who deleted the category.
+     * Must be a valid MongoDB ObjectId.
+     *
+     * @example "507f1f77bcf86cd799439011"
+     */
+    deletedBy: string;
+}

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

@@ -0,0 +1,44 @@
+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);
+};
+import { IsString, IsMongoId, IsUUID } from 'class-validator';
+/**
+ * DTO for deleting a category.
+ *
+ * Used by the Products microservice to soft-delete categories.
+ * Includes category ID and user who performed the deletion.
+ *
+ * @since 2.0.0
+ */
+export class DeleteCategoryDto {
+    /**
+     * Category ID to delete.
+     * Must be a valid UUID.
+     *
+     * @example "550e8400-e29b-41d4-a716-446655440000"
+     */
+    id;
+    /**
+     * User who deleted the category.
+     * Must be a valid MongoDB ObjectId.
+     *
+     * @example "507f1f77bcf86cd799439011"
+     */
+    deletedBy;
+}
+__decorate([
+    IsString(),
+    IsUUID(),
+    __metadata("design:type", String)
+], DeleteCategoryDto.prototype, "id", void 0);
+__decorate([
+    IsString(),
+    IsMongoId(),
+    __metadata("design:type", String)
+], DeleteCategoryDto.prototype, "deletedBy", void 0);

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

@@ -0,0 +1,11 @@
+/**
+ * Category DTOs.
+ *
+ * This module exports DTOs used for category management
+ * in the Products microservice.
+ *
+ * @since 2.0.0
+ */
+export * from './create-category.dto';
+export * from './update-category.dto';
+export * from './delete-category.dto';

package/dist/dtos/categories/index.js

@@ -0,0 +1,11 @@
+/**
+ * Category DTOs.
+ *
+ * This module exports DTOs used for category management
+ * in the Products microservice.
+ *
+ * @since 2.0.0
+ */
+export * from './create-category.dto';
+export * from './update-category.dto';
+export * from './delete-category.dto';

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

@@ -0,0 +1,26 @@
+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.
+ *
+ * @since 2.0.0
+ */
+export declare class UpdateCategoryDto extends UpdateCategoryDto_base {
+    /**
+     * Category ID to update.
+     * Must be a valid UUID.
+     *
+     * @example "550e8400-e29b-41d4-a716-446655440000"
+     */
+    id?: string;
+    /**
+     * User who updated the category.
+     * Must be a valid MongoDB ObjectId if provided.
+     *
+     * @example "507f1f77bcf86cd799439011"
+     */
+    updatedBy?: string;
+}
+export {};

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

@@ -0,0 +1,48 @@
+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);
+};
+import { PartialType } from '@nestjs/mapped-types';
+import { IsString, IsOptional, IsMongoId, IsUUID } from 'class-validator';
+import { CreateCategoryDto } from './create-category.dto';
+/**
+ * DTO for updating an existing category.
+ *
+ * Extends CreateCategoryDto with all fields optional.
+ * Used by the Products microservice to update category details.
+ *
+ * @since 2.0.0
+ */
+export class UpdateCategoryDto extends PartialType(CreateCategoryDto) {
+    /**
+     * Category ID to update.
+     * Must be a valid UUID.
+     *
+     * @example "550e8400-e29b-41d4-a716-446655440000"
+     */
+    id;
+    /**
+     * User who updated the category.
+     * Must be a valid MongoDB ObjectId if provided.
+     *
+     * @example "507f1f77bcf86cd799439011"
+     */
+    updatedBy;
+}
+__decorate([
+    IsString(),
+    IsUUID(),
+    IsOptional(),
+    __metadata("design:type", String)
+], UpdateCategoryDto.prototype, "id", void 0);
+__decorate([
+    IsString(),
+    IsMongoId(),
+    IsOptional(),
+    __metadata("design:type", String)
+], UpdateCategoryDto.prototype, "updatedBy", void 0);

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

@@ -0,0 +1,43 @@
+import { Currency } from '../../enums/currency.enum';
+/**
+ * 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.
+ *
+ * @since 2.0.0
+ */
+export declare class CreateChainDto {
+    /**
+     * Chain name.
+     * Must not be empty.
+     *
+     * @example "McDonald's"
+     */
+    name: string;
+    /**
+     * Chain currency code.
+     * Must be a valid Currency enum value.
+     * Defaults to PEN if not provided.
+     *
+     * @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.
+     *
+     * @example 8.5
+     * @default 0.0
+     */
+    taxPercent?: number;
+    /**
+     * User who created the chain.
+     * Must be a valid MongoDB ObjectId if provided.
+     *
+     * @example "507f1f77bcf86cd799439011"
+     */
+    createdBy?: string;
+}

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

@@ -0,0 +1,75 @@
+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);
+};
+import { IsString, IsOptional, IsNumber, Min, Max, IsEnum, IsMongoId } from 'class-validator';
+import { Currency } from '../../enums/currency.enum';
+/**
+ * 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.
+ *
+ * @since 2.0.0
+ */
+export class CreateChainDto {
+    /**
+     * Chain name.
+     * Must not be empty.
+     *
+     * @example "McDonald's"
+     */
+    name;
+    /**
+     * Chain currency code.
+     * Must be a valid Currency enum value.
+     * Defaults to PEN if not provided.
+     *
+     * @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.
+     *
+     * @example 8.5
+     * @default 0.0
+     */
+    taxPercent = 0.0;
+    /**
+     * User who created the chain.
+     * Must be a valid MongoDB ObjectId if provided.
+     *
+     * @example "507f1f77bcf86cd799439011"
+     */
+    createdBy;
+}
+__decorate([
+    IsString(),
+    __metadata("design:type", String)
+], CreateChainDto.prototype, "name", void 0);
+__decorate([
+    IsOptional(),
+    IsEnum(Currency, { message: 'Currency must be a valid currency code' }),
+    __metadata("design:type", String)
+], CreateChainDto.prototype, "currency", void 0);
+__decorate([
+    IsOptional(),
+    IsNumber({}, { message: 'Tax percentage must be a number' }),
+    Min(0, { message: 'Tax percentage must be at least 0' }),
+    Max(100, { message: 'Tax percentage must be at most 100' }),
+    __metadata("design:type", Number)
+], CreateChainDto.prototype, "taxPercent", void 0);
+__decorate([
+    IsOptional(),
+    IsString(),
+    IsMongoId(),
+    __metadata("design:type", String)
+], CreateChainDto.prototype, "createdBy", void 0);

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

@@ -0,0 +1,24 @@
+/**
+ * DTO for deleting a chain.
+ *
+ * Used by the Products microservice to soft-delete chains.
+ * Includes chain ID and user who performed the deletion.
+ *
+ * @since 2.0.0
+ */
+export declare class DeleteChainDto {
+    /**
+     * Chain ID to delete.
+     * Must be a valid UUID.
+     *
+     * @example "550e8400-e29b-41d4-a716-446655440000"
+     */
+    id: string;
+    /**
+     * User who deleted the chain.
+     * Must be a valid MongoDB ObjectId.
+     *
+     * @example "507f1f77bcf86cd799439011"
+     */
+    deletedBy: string;
+}

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

@@ -0,0 +1,44 @@
+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);
+};
+import { IsString, IsMongoId, IsUUID } from 'class-validator';
+/**
+ * DTO for deleting a chain.
+ *
+ * Used by the Products microservice to soft-delete chains.
+ * Includes chain ID and user who performed the deletion.
+ *
+ * @since 2.0.0
+ */
+export class DeleteChainDto {
+    /**
+     * Chain ID to delete.
+     * Must be a valid UUID.
+     *
+     * @example "550e8400-e29b-41d4-a716-446655440000"
+     */
+    id;
+    /**
+     * User who deleted the chain.
+     * Must be a valid MongoDB ObjectId.
+     *
+     * @example "507f1f77bcf86cd799439011"
+     */
+    deletedBy;
+}
+__decorate([
+    IsString(),
+    IsUUID(),
+    __metadata("design:type", String)
+], DeleteChainDto.prototype, "id", void 0);
+__decorate([
+    IsString(),
+    IsMongoId(),
+    __metadata("design:type", String)
+], DeleteChainDto.prototype, "deletedBy", void 0);

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

@@ -0,0 +1,11 @@
+/**
+ * Chain DTOs.
+ *
+ * This module exports DTOs used for chain management
+ * in the Products microservice.
+ *
+ * @since 2.0.0
+ */
+export * from './create-chain.dto';
+export * from './update-chain.dto';
+export * from './delete-chain.dto';

package/dist/dtos/chain/index.js

@@ -0,0 +1,11 @@
+/**
+ * Chain DTOs.
+ *
+ * This module exports DTOs used for chain management
+ * in the Products microservice.
+ *
+ * @since 2.0.0
+ */
+export * from './create-chain.dto';
+export * from './update-chain.dto';
+export * from './delete-chain.dto';

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

@@ -0,0 +1,26 @@
+declare const UpdateChainDto_base: import("@nestjs/mapped-types").MappedType<Partial<unknown>>;
+/**
+ * DTO for updating an existing chain.
+ *
+ * Extends CreateChainDto with all fields optional.
+ * Used by the Products microservice to update chain details.
+ *
+ * @since 2.0.0
+ */
+export declare class UpdateChainDto extends UpdateChainDto_base {
+    /**
+     * Chain ID to update.
+     * Must be a valid UUID.
+     *
+     * @example "550e8400-e29b-41d4-a716-446655440000"
+     */
+    id?: string;
+    /**
+     * User who updated the chain.
+     * Must be a valid MongoDB ObjectId if provided.
+     *
+     * @example "507f1f77bcf86cd799439011"
+     */
+    updatedBy?: string;
+}
+export {};

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

@@ -0,0 +1,48 @@
+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);
+};
+import { PartialType } from '@nestjs/mapped-types';
+import { IsString, IsOptional, IsMongoId, IsUUID } from 'class-validator';
+import { CreateChainDto } from './create-chain.dto';
+/**
+ * DTO for updating an existing chain.
+ *
+ * Extends CreateChainDto with all fields optional.
+ * Used by the Products microservice to update chain details.
+ *
+ * @since 2.0.0
+ */
+export class UpdateChainDto extends PartialType(CreateChainDto) {
+    /**
+     * Chain ID to update.
+     * Must be a valid UUID.
+     *
+     * @example "550e8400-e29b-41d4-a716-446655440000"
+     */
+    id;
+    /**
+     * User who updated the chain.
+     * Must be a valid MongoDB ObjectId if provided.
+     *
+     * @example "507f1f77bcf86cd799439011"
+     */
+    updatedBy;
+}
+__decorate([
+    IsString(),
+    IsUUID(),
+    IsOptional(),
+    __metadata("design:type", String)
+], UpdateChainDto.prototype, "id", void 0);
+__decorate([
+    IsString(),
+    IsMongoId(),
+    IsOptional(),
+    __metadata("design:type", String)
+], UpdateChainDto.prototype, "updatedBy", void 0);

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

@@ -0,0 +1,9 @@
+/**
+ * Common DTOs used across all microservices.
+ *
+ * This module exports shared DTOs that are used by multiple
+ * microservices for consistency and reusability.
+ *
+ * @since 2.0.0
+ */
+export * from './pagination.dto';

package/dist/dtos/common/index.js

@@ -0,0 +1,9 @@
+/**
+ * Common DTOs used across all microservices.
+ *
+ * This module exports shared DTOs that are used by multiple
+ * microservices for consistency and reusability.
+ *
+ * @since 2.0.0
+ */
+export * from './pagination.dto';

package/dist/dtos/common/pagination.dto.d.ts

@@ -0,0 +1,27 @@
+/**
+ * DTO for pagination parameters.
+ *
+ * Used across all microservices for consistent pagination handling.
+ * This DTO provides a standardized way to request paginated data with
+ * limit and page number.
+ *
+ * @since 2.0.0
+ */
+export declare class PaginationDto {
+    /**
+     * Maximum number of items to return per page.
+     * Must be a positive number.
+     *
+     * @example 10
+     * @default 10
+     */
+    limit: number;
+    /**
+     * Page number to retrieve (1-indexed).
+     * Must be a positive number.
+     *
+     * @example 1
+     * @default 1
+     */
+    page: number;
+}

package/dist/dtos/common/pagination.dto.js

@@ -0,0 +1,50 @@
+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);
+};
+import { Type } from 'class-transformer';
+import { IsOptional, IsPositive } from 'class-validator';
+/**
+ * DTO for pagination parameters.
+ *
+ * Used across all microservices for consistent pagination handling.
+ * This DTO provides a standardized way to request paginated data with
+ * limit and page number.
+ *
+ * @since 2.0.0
+ */
+export class PaginationDto {
+    /**
+     * Maximum number of items to return per page.
+     * Must be a positive number.
+     *
+     * @example 10
+     * @default 10
+     */
+    limit = 10;
+    /**
+     * Page number to retrieve (1-indexed).
+     * Must be a positive number.
+     *
+     * @example 1
+     * @default 1
+     */
+    page = 1;
+}
+__decorate([
+    IsOptional(),
+    IsPositive(),
+    Type(() => Number),
+    __metadata("design:type", Number)
+], PaginationDto.prototype, "limit", void 0);
+__decorate([
+    IsOptional(),
+    IsPositive(),
+    Type(() => Number),
+    __metadata("design:type", Number)
+], PaginationDto.prototype, "page", void 0);

package/dist/dtos/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Centralized DTOs for the QeHay platform.
+ *
+ * This module exports all DTOs organized by domain for use across
+ * all microservices and the client gateway.
+ *
+ * Usage examples:
+ *    - import { CreateOrderDto, OrderItemDto } from 'looroh-sdk-qhay-interfaces';
+ *    - import { CreateProductDto, UpdateProductDto } from 'looroh-sdk-qhay-interfaces';
+ *    - import { PaymentSessionDto } from 'looroh-sdk-qhay-interfaces';
+ *
+ * All DTOs include validation decorators from class-validator and
+ * are properly documented for API documentation generation.
+ *
+ * @since 2.0.0
+ */
+export * from "./common";
+export * from "./auth";
+export * from "./orders";
+export * from "./payments";
+export * from "./products";
+export * from "./categories";
+export * from "./restaurants";
+export * from "./chain";
+export * from "./tags";
+export * from "./ingredients";
+export * from "./questions";
+export * from "./translations";