qeai-sdk 2.0.0

package/dist/dtos/payments/payment-session.dto.js

@@ -0,0 +1,111 @@
+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 { IsString, IsNotEmpty, IsArray, ValidateNested, IsOptional, IsNumber, IsEmail, IsPositive, } from 'class-validator';
+import { PaymentSessionItemDto } from './payment-session-item.dto';
+/**
+ * DTO for creating a payment session.
+ *
+ * Used by the Payments microservice to create payment sessions
+ * with order details, payment method, and customer information.
+ * This DTO is sent to payment providers (e.g., Stripe) to initiate payment.
+ *
+ * @since 2.0.0
+ */
+export class PaymentSessionDto {
+    /**
+     * Unique identifier of the order being paid.
+     * Must not be empty.
+     *
+     * @example "550e8400-e29b-41d4-a716-446655440000"
+     */
+    orderId;
+    /**
+     * Optional currency code for the payment.
+     * Should follow ISO 4217 format (e.g., USD, PEN, EUR).
+     *
+     * @example "PEN"
+     * @default "PEN"
+     */
+    currency;
+    /**
+     * Payment method identifier.
+     * Must not be empty.
+     *
+     * @example "payment-method-uuid-123"
+     */
+    paymentMethodId;
+    /**
+     * Optional customer email address.
+     * Must be a valid email format if provided.
+     *
+     * @example "customer@example.com"
+     */
+    customerEmail;
+    /**
+     * Optional token identifier for saved payment methods.
+     *
+     * @example "token-uuid-123"
+     */
+    tokenId;
+    /**
+     * Optional total amount for the payment.
+     * Must be a positive number if provided.
+     * If not provided, the total will be calculated from items.
+     *
+     * @example 29.99
+     */
+    totalAmount;
+    /**
+     * Array of items in the payment session.
+     * Must contain at least one item.
+     * Each item is validated as a PaymentSessionItemDto.
+     *
+     * @example [{ productId: "...", name: "Big Mac", quantity: 2, price: 19.98 }]
+     */
+    items;
+}
+__decorate([
+    IsString(),
+    IsNotEmpty({ message: 'Order ID is required' }),
+    __metadata("design:type", String)
+], PaymentSessionDto.prototype, "orderId", void 0);
+__decorate([
+    IsString(),
+    IsOptional(),
+    __metadata("design:type", String)
+], PaymentSessionDto.prototype, "currency", void 0);
+__decorate([
+    IsString(),
+    IsNotEmpty({ message: 'Payment method ID is required' }),
+    __metadata("design:type", String)
+], PaymentSessionDto.prototype, "paymentMethodId", void 0);
+__decorate([
+    IsOptional(),
+    IsEmail({}, { message: 'Invalid email format' }),
+    __metadata("design:type", String)
+], PaymentSessionDto.prototype, "customerEmail", void 0);
+__decorate([
+    IsOptional(),
+    IsString(),
+    __metadata("design:type", String)
+], PaymentSessionDto.prototype, "tokenId", void 0);
+__decorate([
+    IsOptional(),
+    IsNumber(),
+    IsPositive(),
+    __metadata("design:type", Number)
+], PaymentSessionDto.prototype, "totalAmount", void 0);
+__decorate([
+    IsArray(),
+    ValidateNested({ each: true }),
+    Type(() => PaymentSessionItemDto),
+    __metadata("design:type", Array)
+], PaymentSessionDto.prototype, "items", void 0);

package/dist/dtos/payments/webhook-data.dto.d.ts

@@ -0,0 +1,39 @@
+/**
+ * DTO representing webhook data received from payment providers.
+ *
+ * Used by the Payments microservice to handle webhook events
+ * from payment providers (e.g., Stripe webhooks).
+ * Contains raw body, payment method identifier, and optional signature/headers.
+ *
+ * @since 2.0.0
+ */
+export declare class WebhookDataDto {
+    /**
+     * Raw body of the webhook request as a string.
+     * Used for signature verification.
+     *
+     * @example "{\"type\":\"payment_intent.succeeded\",\"data\":{...}}"
+     */
+    rawBody: string;
+    /**
+     * Payment method identifier associated with the webhook.
+     * Must not be empty.
+     *
+     * @example "stripe"
+     */
+    paymentMethodId: string;
+    /**
+     * Optional signature from the payment provider.
+     * Used for webhook signature verification (e.g., Stripe signature).
+     *
+     * @example "t=1234567890,v1=abc123..."
+     */
+    stripeSignature?: string;
+    /**
+     * Optional webhook request headers.
+     * Used for additional verification or context.
+     *
+     * @example { "x-stripe-signature": "t=1234567890,v1=abc123..." }
+     */
+    headers?: Record<string, string>;
+}

package/dist/dtos/payments/webhook-data.dto.js

@@ -0,0 +1,68 @@
+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, IsObject, IsNotEmpty } from 'class-validator';
+/**
+ * DTO representing webhook data received from payment providers.
+ *
+ * Used by the Payments microservice to handle webhook events
+ * from payment providers (e.g., Stripe webhooks).
+ * Contains raw body, payment method identifier, and optional signature/headers.
+ *
+ * @since 2.0.0
+ */
+export class WebhookDataDto {
+    /**
+     * Raw body of the webhook request as a string.
+     * Used for signature verification.
+     *
+     * @example "{\"type\":\"payment_intent.succeeded\",\"data\":{...}}"
+     */
+    rawBody;
+    /**
+     * Payment method identifier associated with the webhook.
+     * Must not be empty.
+     *
+     * @example "stripe"
+     */
+    paymentMethodId;
+    /**
+     * Optional signature from the payment provider.
+     * Used for webhook signature verification (e.g., Stripe signature).
+     *
+     * @example "t=1234567890,v1=abc123..."
+     */
+    stripeSignature;
+    /**
+     * Optional webhook request headers.
+     * Used for additional verification or context.
+     *
+     * @example { "x-stripe-signature": "t=1234567890,v1=abc123..." }
+     */
+    headers;
+}
+__decorate([
+    IsString(),
+    __metadata("design:type", String)
+], WebhookDataDto.prototype, "rawBody", void 0);
+__decorate([
+    IsString(),
+    IsNotEmpty({ message: 'Payment method ID is required' }),
+    __metadata("design:type", String)
+], WebhookDataDto.prototype, "paymentMethodId", void 0);
+__decorate([
+    IsOptional(),
+    IsString(),
+    __metadata("design:type", String)
+], WebhookDataDto.prototype, "stripeSignature", void 0);
+__decorate([
+    IsOptional(),
+    IsObject(),
+    __metadata("design:type", Object)
+], WebhookDataDto.prototype, "headers", void 0);

package/dist/dtos/products/create-product.dto.d.ts

@@ -0,0 +1,54 @@
+import { ProductStatus } from '../../enums';
+/**
+ * DTO for creating a new product.
+ *
+ * Used by the Products microservice to create new products
+ * with SKU, name, description, base price, and status.
+ *
+ * @since 2.0.0
+ */
+export declare class CreateProductDto {
+    /**
+     * Product SKU (Stock Keeping Unit).
+     * Optional unique identifier for inventory management.
+     *
+     * @example "PROD-001"
+     */
+    sku?: string;
+    /**
+     * Product name.
+     * Must not be empty.
+     *
+     * @example "Big Mac"
+     */
+    name: string;
+    /**
+     * Product description.
+     * Optional detailed description of the product.
+     *
+     * @example "Two all-beef patties, special sauce, lettuce, cheese, pickles, onions on a sesame seed bun"
+     */
+    description?: string;
+    /**
+     * Product base price.
+     * Must be a number with maximum 4 decimal places and minimum value of 0.
+     *
+     * @example 5.99
+     */
+    basePrice: number;
+    /**
+     * Product status.
+     * Defaults to ACTIVE if not provided.
+     *
+     * @example ProductStatus.ACTIVE
+     * @default ProductStatus.ACTIVE
+     */
+    status?: ProductStatus;
+    /**
+     * User who created the product.
+     * Must be a valid MongoDB ObjectId.
+     *
+     * @example "507f1f77bcf86cd799439011"
+     */
+    createdBy?: string;
+}

package/dist/dtos/products/create-product.dto.js

@@ -0,0 +1,99 @@
+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, IsNotEmpty, IsNumber, Min, IsOptional, IsEnum, IsMongoId } from 'class-validator';
+import { Type } from 'class-transformer';
+import { ProductStatus } from '../../enums';
+/**
+ * DTO for creating a new product.
+ *
+ * Used by the Products microservice to create new products
+ * with SKU, name, description, base price, and status.
+ *
+ * @since 2.0.0
+ */
+export class CreateProductDto {
+    /**
+     * Product SKU (Stock Keeping Unit).
+     * Optional unique identifier for inventory management.
+     *
+     * @example "PROD-001"
+     */
+    sku;
+    /**
+     * Product name.
+     * Must not be empty.
+     *
+     * @example "Big Mac"
+     */
+    name;
+    /**
+     * Product description.
+     * Optional detailed description of the product.
+     *
+     * @example "Two all-beef patties, special sauce, lettuce, cheese, pickles, onions on a sesame seed bun"
+     */
+    description;
+    /**
+     * Product base price.
+     * Must be a number with maximum 4 decimal places and minimum value of 0.
+     *
+     * @example 5.99
+     */
+    basePrice;
+    /**
+     * Product status.
+     * Defaults to ACTIVE if not provided.
+     *
+     * @example ProductStatus.ACTIVE
+     * @default ProductStatus.ACTIVE
+     */
+    status = ProductStatus.ACTIVE;
+    /**
+     * User who created the product.
+     * Must be a valid MongoDB ObjectId.
+     *
+     * @example "507f1f77bcf86cd799439011"
+     */
+    createdBy;
+}
+__decorate([
+    IsOptional(),
+    IsString(),
+    __metadata("design:type", String)
+], CreateProductDto.prototype, "sku", void 0);
+__decorate([
+    IsString(),
+    IsNotEmpty({ message: 'Product name is required' }),
+    __metadata("design:type", String)
+], CreateProductDto.prototype, "name", void 0);
+__decorate([
+    IsOptional(),
+    IsString(),
+    __metadata("design:type", String)
+], CreateProductDto.prototype, "description", void 0);
+__decorate([
+    IsNumber({
+        maxDecimalPlaces: 4,
+    }, { message: 'Base price must be a number with maximum 4 decimal places' }),
+    Type(() => Number),
+    Min(0, { message: 'Base price must be greater than or equal to 0' }),
+    __metadata("design:type", Number)
+], CreateProductDto.prototype, "basePrice", void 0);
+__decorate([
+    IsOptional(),
+    IsEnum(ProductStatus, { message: 'Status must be ACTIVE, INACTIVE, or OUT_OF_STOCK' }),
+    __metadata("design:type", String)
+], CreateProductDto.prototype, "status", void 0);
+__decorate([
+    IsString(),
+    IsMongoId(),
+    IsOptional(),
+    __metadata("design:type", String)
+], CreateProductDto.prototype, "createdBy", void 0);

package/dist/dtos/products/delete-product.dto.d.ts

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * Product DTOs.
+ *
+ * This module exports DTOs used for product management
+ * in the Products microservice and Client Gateway.
+ *
+ * @since 2.0.0
+ */
+export * from "./create-product.dto";
+export * from "./update-product.dto";
+export * from "./delete-product.dto";
+export * from "./submodules";

package/dist/dtos/products/index.js

@@ -0,0 +1,13 @@
+/**
+ * Product DTOs.
+ *
+ * This module exports DTOs used for product management
+ * in the Products microservice and Client Gateway.
+ *
+ * @since 2.0.0
+ */
+export * from "./create-product.dto";
+export * from "./update-product.dto";
+export * from "./delete-product.dto";
+// Submodules
+export * from "./submodules";

package/dist/dtos/products/submodules/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./product-tag";
+export * from "./product-size";
+export * from "./product-image";
+export * from "./product-schedule";
+export * from "./product-recipe";
+export * from "./product-question";

package/dist/dtos/products/submodules/index.js

@@ -0,0 +1,7 @@
+// Submodules
+export * from "./product-tag";
+export * from "./product-size";
+export * from "./product-image";
+export * from "./product-schedule";
+export * from "./product-recipe";
+export * from "./product-question";

package/dist/dtos/products/submodules/product-image/bulk-create-product-image.dto.d.ts

@@ -0,0 +1,26 @@
+import { CreateProductImageDto } from './create-product-image.dto';
+/**
+ * DTO for bulk creating product images.
+ *
+ * Used by the Products microservice to create multiple images
+ * for a product in a single operation.
+ *
+ * @since 2.0.0
+ */
+export declare class BulkCreateProductImageDto {
+    /**
+     * Optional unique identifier of the product.
+     * Must be a valid UUID if provided.
+     *
+     * @example "550e8400-e29b-41d4-a716-446655440000"
+     */
+    productId?: string;
+    /**
+     * Array of images to create.
+     * Must contain at least one image.
+     * Each image is validated as a CreateProductImageDto.
+     *
+     * @example [{ url: "https://example.com/image1.jpg", isPrimary: true }]
+     */
+    images: CreateProductImageDto[];
+}

package/dist/dtos/products/submodules/product-image/bulk-create-product-image.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 { IsString, IsArray, ValidateNested, ArrayMinSize, IsOptional, IsUUID, } from 'class-validator';
+import { Type } from 'class-transformer';
+import { CreateProductImageDto } from './create-product-image.dto';
+/**
+ * DTO for bulk creating product images.
+ *
+ * Used by the Products microservice to create multiple images
+ * for a product in a single operation.
+ *
+ * @since 2.0.0
+ */
+export class BulkCreateProductImageDto {
+    /**
+     * Optional unique identifier of the product.
+     * Must be a valid UUID if provided.
+     *
+     * @example "550e8400-e29b-41d4-a716-446655440000"
+     */
+    productId;
+    /**
+     * Array of images to create.
+     * Must contain at least one image.
+     * Each image is validated as a CreateProductImageDto.
+     *
+     * @example [{ url: "https://example.com/image1.jpg", isPrimary: true }]
+     */
+    images;
+}
+__decorate([
+    IsString(),
+    IsOptional(),
+    IsUUID(),
+    __metadata("design:type", String)
+], BulkCreateProductImageDto.prototype, "productId", void 0);
+__decorate([
+    IsArray(),
+    ArrayMinSize(1, { message: 'At least one image is required' }),
+    ValidateNested({ each: true }),
+    Type(() => CreateProductImageDto),
+    __metadata("design:type", Array)
+], BulkCreateProductImageDto.prototype, "images", void 0);

package/dist/dtos/products/submodules/product-image/create-product-image.dto.d.ts

@@ -0,0 +1,32 @@
+/**
+ * DTO for creating a new product image.
+ *
+ * Used by the Products microservice to create image associations for products.
+ * Images can be set as primary for display purposes.
+ *
+ * @since 2.0.0
+ */
+export declare class CreateProductImageDto {
+    /**
+     * Optional unique identifier of the product.
+     * Must be a valid UUID if provided.
+     *
+     * @example "550e8400-e29b-41d4-a716-446655440000"
+     */
+    productId?: string;
+    /**
+     * Image URL.
+     * Must be a valid URL format and not be empty.
+     *
+     * @example "https://example.com/images/product-123.jpg"
+     */
+    url: string;
+    /**
+     * Whether this is the primary image for the product.
+     * Defaults to false if not provided.
+     *
+     * @example true
+     * @default false
+     */
+    isPrimary?: boolean;
+}

package/dist/dtos/products/submodules/product-image/create-product-image.dto.js

@@ -0,0 +1,59 @@
+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, IsNotEmpty, IsOptional, IsBoolean, IsUrl, IsUUID } from 'class-validator';
+/**
+ * DTO for creating a new product image.
+ *
+ * Used by the Products microservice to create image associations for products.
+ * Images can be set as primary for display purposes.
+ *
+ * @since 2.0.0
+ */
+export class CreateProductImageDto {
+    /**
+     * Optional unique identifier of the product.
+     * Must be a valid UUID if provided.
+     *
+     * @example "550e8400-e29b-41d4-a716-446655440000"
+     */
+    productId;
+    /**
+     * Image URL.
+     * Must be a valid URL format and not be empty.
+     *
+     * @example "https://example.com/images/product-123.jpg"
+     */
+    url;
+    /**
+     * Whether this is the primary image for the product.
+     * Defaults to false if not provided.
+     *
+     * @example true
+     * @default false
+     */
+    isPrimary;
+}
+__decorate([
+    IsString(),
+    IsOptional(),
+    IsUUID(),
+    __metadata("design:type", String)
+], CreateProductImageDto.prototype, "productId", void 0);
+__decorate([
+    IsString(),
+    IsNotEmpty({ message: 'Image URL is required' }),
+    IsUrl({}, { message: 'Image URL must be a valid URL' }),
+    __metadata("design:type", String)
+], CreateProductImageDto.prototype, "url", void 0);
+__decorate([
+    IsOptional(),
+    IsBoolean(),
+    __metadata("design:type", Boolean)
+], CreateProductImageDto.prototype, "isPrimary", void 0);

package/dist/dtos/products/submodules/product-image/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Product Image DTOs.
+ *
+ * This module exports DTOs used for managing product images
+ * in the Products microservice.
+ *
+ * @since 2.0.0
+ */
+export * from './create-product-image.dto';
+export * from './update-product-image.dto';
+export * from './bulk-create-product-image.dto';
+export * from './set-primary-image.dto';

package/dist/dtos/products/submodules/product-image/index.js

@@ -0,0 +1,12 @@
+/**
+ * Product Image DTOs.
+ *
+ * This module exports DTOs used for managing product images
+ * in the Products microservice.
+ *
+ * @since 2.0.0
+ */
+export * from './create-product-image.dto';
+export * from './update-product-image.dto';
+export * from './bulk-create-product-image.dto';
+export * from './set-primary-image.dto';