@retaila/shared-types 1.1.21 → 1.1.22

package/dist/index.d.mts

@@ -356,6 +356,111 @@ interface CustomerUpsertDto {
     phone?: Phone;
 }
 
+/**
+ * Entidad Product
+ * Representa un producto vendible en la tienda. Es la entidad base que puede tener múltiples variantes.
+ */
+interface Product {
+    id: string;
+    accountId: string;
+    code: string;
+    brandId?: string | null;
+    supplierId?: string | null;
+    productType: ProductType;
+    sku?: string | null;
+    barcode?: string | null;
+    name: string;
+    slug: string;
+    description?: string | null;
+    isFeatured: boolean;
+    allowBackorder: boolean;
+    weight?: number | null;
+    weightUnit?: string | null;
+    height?: number | null;
+    width?: number | null;
+    depth?: number | null;
+    dimensionUnit?: string | null;
+    shippingLeadTime?: string | null;
+    status: ProductStatus;
+    createdAt: Date;
+    updatedAt: Date;
+    deletedAt?: Date | null;
+    media?: Media[];
+}
+declare enum ProductStatus {
+    ACTIVE = "ACTIVE",// Available for sale
+    INACTIVE = "INACTIVE",// Not visible/purchasable
+    ARCHIVED = "ARCHIVED",// Not visible, kept for records
+    DRAFT = "DRAFT"
+}
+declare enum ProductType {
+    SIMPLE = "SIMPLE",// Product without variants (may have a default hidden variant)
+    VARIABLE = "VARIABLE",// Product with distinct variants (color, size, etc.)
+    BUNDLE = "BUNDLE",// A package of other products/variants
+    GIFT_CARD = "GIFT_CARD"
+}
+interface ProductVariant {
+    id: string;
+    accountId: string;
+    productId: string;
+    sku?: string | null;
+    barcode?: string | null;
+    currency: string;
+    price: number;
+    compareAtPrice?: number;
+    allowBackorder?: boolean;
+    stock: number;
+    weight?: number | null;
+    weightUnit?: string | null;
+    height?: number | null;
+    width?: number | null;
+    depth?: number | null;
+    dimensionUnit?: string | null;
+    shippingLeadTime?: string | null;
+    order: number;
+    createdAt: Date;
+    updatedAt: Date;
+    deletedAt?: Date;
+}
+
+type FulfillmentItem = {
+    id: string;
+    fulfillmentId: string;
+    orderItemId: string;
+    quantity: number;
+};
+
+type CreateFulfillmentItemDto = {
+    orderItemId: string;
+    quantity: string;
+};
+
+declare enum FulfillmentStatus {
+    PENDING = "pending",
+    PACKED = "packed",
+    SHIPPED = "shipped",
+    DELIVERED = "delivered",
+    CANCELLED = "cancelled"
+}
+type Fulfillment = {
+    id: string;
+    accountId: string;
+    orderId: string;
+    accountBranchId: string;
+    carrier: string;
+    trackingNumber: string | null;
+    items: FulfillmentItem[];
+    status: FulfillmentStatus;
+    data: Record<string, unknown> | null;
+    packedAt: Date | null;
+    shippedAt: Date | null;
+    deliveredAt: Date | null;
+    cancelledAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+    deletedAt?: Date;
+};
+
 /**
  * Entidad Order
  * Define la orden de compra de un cliente en el sitio web.
@@ -385,7 +490,7 @@ interface Order {
     totalRefunded: number;
     status: OrderStatus;
     paymentStatus: OrderPaymentStatus;
-    fulfillmentStatus: OrderFulfillmentStatus;
+    fulfillmentStatus: FulfillmentStatus;
     statusHistory?: StatusChangeHistory[];
     customerNote?: string;
     internalNote?: string;
@@ -423,6 +528,7 @@ interface OrderItem {
     taxName?: string;
     createdAt: Date;
     updatedAt: Date;
+    product?: Product;
 }
 declare enum OrderStatus {
     PENDING = "PENDING",// Order placed, awaiting payment confirmation
@@ -442,11 +548,6 @@ declare enum OrderPaymentStatus {
     REFUNDED = "REFUNDED",
     PARTIALLY_REFUNDED = "PARTIALLY_REFUNDED"
 }
-declare enum OrderFulfillmentStatus {
-    PENDING = "PENDING",
-    PARTIAL = "PARTIAL",
-    FULFILLED = "FULFILLED"
-}
 declare enum OrderSource {
     WEB = "WEB",
     POS = "POS",
@@ -586,6 +687,8 @@ interface Cart {
     subtotal: number;
     total: number;
     deliveryType: CartDeliveryType;
+    deliveryOptionId?: string;
+    pickupBranchId?: string;
     itemCount: number;
     createdAt: Date;
     updatedAt: Date;
@@ -602,8 +705,8 @@ interface Cart {
     totalTax?: number;
     totalPrice?: number;
     taxDetails?: any;
-    customer?: Customer | null;
-    accountDomain?: AccountDomain;
+    customer?: Partial<Customer> | null;
+    accountDomain?: Partial<AccountDomain> | null;
 }
 interface CartItem {
     id: string;
@@ -637,7 +740,7 @@ declare enum CartSource {
     API = "API"
 }
 declare enum CartDeliveryType {
-    DELIVERY = "delivery",
+    SHIPPING = "shipping",
     PICKUP = "pickup"
 }
 
@@ -649,7 +752,8 @@ declare enum PaymentStatus {
     REJECTED = "REJECTED",// Pago rechazado
     REFUND_IN_PROCESS = "REFUND_IN_PROCESS",// En proceso de reembolso con la plataforma de pagos
     PARTIAL_REFUND = "PARTIAL_REFUND",// Pago parcialmente reembolsado
-    REFUNDED = "REFUNDED"
+    REFUNDED = "REFUNDED",// Pago reembolsado
+    ERROR = "ERROR"
 }
 declare enum PaymentMethodType {
     BANK_TRANSFER = "BANK_TRANSFER",
@@ -679,125 +783,54 @@ interface Payment {
     status: PaymentStatus;
     cardBrand?: string;
     cardLast4?: string;
+    data?: Record<string, unknown>;
     metadata?: Record<string, any>;
     demo: boolean;
     createdAt: string | Date;
     updatedAt: string | Date;
     deletedAt?: string | Date;
 }
-
-/**
- * Entidad Product
- * Representa un producto vendible en la tienda. Es la entidad base que puede tener múltiples variantes.
- */
-interface Product {
-    id: string;
-    accountId: string;
-    code: string;
-    brandId?: string | null;
-    supplierId?: string | null;
-    productType: ProductType;
-    sku?: string | null;
-    barcode?: string | null;
-    name: string;
-    slug: string;
-    description?: string | null;
-    isFeatured: boolean;
-    allowBackorder: boolean;
-    weight?: number | null;
-    weightUnit?: string | null;
-    height?: number | null;
-    width?: number | null;
-    depth?: number | null;
-    dimensionUnit?: string | null;
-    shippingLeadTime?: string | null;
-    status: ProductStatus;
-    createdAt: Date;
-    updatedAt: Date;
-    deletedAt?: Date | null;
-}
-declare enum ProductStatus {
-    ACTIVE = "ACTIVE",// Available for sale
-    INACTIVE = "INACTIVE",// Not visible/purchasable
-    ARCHIVED = "ARCHIVED",// Not visible, kept for records
-    DRAFT = "DRAFT"
+type PaymentProviderKey = 'MERCADOPAGO';
+interface PaymentProviderContext {
+    db: unknown;
+    accountIntegrationId: string;
+    providerKey: PaymentProviderKey;
+    environment: 'PRODUCTION' | 'DEVELOPMENT';
+    credentials: Record<string, any>;
 }
-declare enum ProductType {
-    SIMPLE = "SIMPLE",// Product without variants (may have a default hidden variant)
-    VARIABLE = "VARIABLE",// Product with distinct variants (color, size, etc.)
-    BUNDLE = "BUNDLE",// A package of other products/variants
-    GIFT_CARD = "GIFT_CARD"
+interface PaymentProviderInitInput {
+    data: Record<string, any>;
 }
-interface ProductVariant {
-    id: string;
-    accountId: string;
-    productId: string;
-    sku?: string | null;
-    barcode?: string | null;
-    currency: string;
-    price: number;
-    compareAtPrice?: number;
-    allowBackorder?: boolean;
-    stock: number;
-    weight?: number | null;
-    weightUnit?: string | null;
-    height?: number | null;
-    width?: number | null;
-    depth?: number | null;
-    dimensionUnit?: string | null;
-    shippingLeadTime?: string | null;
-    order: number;
-    createdAt: Date;
-    updatedAt: Date;
-    deletedAt?: Date;
+interface PaymentProviderInitOutput {
+    data: Record<string, any>;
+    status: PaymentStatus;
 }
-
-/**
- * Entidad ProductAttribute
- * Define los atributos disponibles que se pueden asignar a las variantes de producto (ej. Color, Talla).
- * Especifica el nombre y tipo del atributo para ayudar en la representación y filtrado.
- */
-interface ProductAttribute {
-    id: string;
-    accountId: string;
-    name: string;
-    alias: string;
-    slug: string;
-    type: ProductAttributeType;
-    isRequired: boolean;
-    suffix: string;
-    status: ProductAttributeStatus;
-    createdAt: Date;
-    updatedAt: Date;
-    deletedAt?: Date | null;
-    options: ProductAttributeOption[];
-    displayOrder: number;
+interface PaymentProviderRefundInput {
+    amount: number;
+    data: Record<string, any>;
 }
-declare enum ProductAttributeStatus {
-    ACTIVE = "ACTIVE",
-    INACTIVE = "INACTIVE"
+interface PaymentProviderRefundOutput {
+    data: Record<string, any>;
 }
-declare enum ProductAttributeType {
-    TEXT = "TEXT",// text input
-    NUMBER = "NUMBER",// number input
-    COLOR = "COLOR",// Special type for color swatches
-    SELECT = "SELECT",// Dropdown list
-    BOOLEAN = "BOOLEAN"
+interface PaymentProviderWebhookResult {
+    order_code: string | null;
+    status: PaymentStatus;
+    data: Record<string, unknown>;
 }
-/**
- * Una opción específica para un atributo (ej. "Talle 42" para el atributo "Talle").
- */
-interface ProductAttributeOption {
-    id: string;
+interface WebhookPayload {
+    provider: string;
     accountId: string;
-    productAttributeId: string;
-    value: string;
-    imageId?: string | null;
-    order: number;
-    createdAt: Date;
-    updatedAt: Date;
-    deletedAt?: Date | null;
-    count: number;
+    payload: {
+        query: Record<string, unknown>;
+        body: Record<string, unknown>;
+        headers: Record<string, unknown>;
+    };
+}
+interface PaymentProviderAdapter {
+    readonly key: PaymentProviderKey;
+    initPayment(input: PaymentProviderInitInput): Promise<PaymentProviderInitOutput>;
+    refund(input: PaymentProviderRefundInput): Promise<PaymentProviderRefundOutput>;
+    processWebhook(input: WebhookPayload['payload']): Promise<PaymentProviderWebhookResult>;
 }
 
 /**
@@ -862,6 +895,61 @@ declare enum ProductCategoryStatus {
     INACTIVE = "INACTIVE"
 }
 
+/**
+ * Entidad ProductAttribute
+ * Define los atributos disponibles que se pueden asignar a las variantes de producto (ej. Color, Talla).
+ * Especifica el nombre y tipo del atributo para ayudar en la representación y filtrado.
+ */
+
+interface ProductAttribute {
+    id: string;
+    accountId: string;
+    name: string;
+    alias: string;
+    slug: string;
+    type: ProductAttributeType;
+    isRequired: boolean;
+    suffix: string;
+    status: ProductAttributeStatus;
+    createdAt: Date;
+    updatedAt: Date;
+    deletedAt?: Date | null;
+    productCategories: ProductCategory[];
+    productCategoryLinks: Array<{
+        categoryId: string;
+        isRequired: boolean;
+        displayOrder: number;
+    }>;
+    options: ProductAttributeOption[];
+    displayOrder: number;
+}
+declare enum ProductAttributeStatus {
+    ACTIVE = "ACTIVE",
+    INACTIVE = "INACTIVE"
+}
+declare enum ProductAttributeType {
+    TEXT = "TEXT",// text input
+    NUMBER = "NUMBER",// number input
+    COLOR = "COLOR",// Special type for color swatches
+    SELECT = "SELECT",// Dropdown list
+    BOOLEAN = "BOOLEAN"
+}
+/**
+ * Una opción específica para un atributo (ej. "Talle 42" para el atributo "Talle").
+ */
+interface ProductAttributeOption {
+    id: string;
+    accountId: string;
+    productAttributeId: string;
+    value: string;
+    imageId?: string | null;
+    order: number;
+    createdAt: Date;
+    updatedAt: Date;
+    deletedAt?: Date | null;
+    count: number;
+}
+
 /**
  * Entidad StoreBanner
  * Banners para la portada de la web de la tienda
@@ -929,8 +1017,121 @@ declare enum StorePageType {
 
 declare enum PubSubTopics {
     ORDER_PLACED = "order-placed",
+    ORDER_CONFIRMED = "order-confirmed",
+    ORDER_PROCESSING = "order-processing",
+    ORDER_PROCESSED = "order-processed",
+    ORDER_COMPLETED = "order-completed",
     PAYMENT_PAID = "payment-paid",
     NOTIFICATION_CREATED = "notification-created"
 }
 
-export { type Account, type AccountBranch, type AccountBranchSchedule, AccountBranchScheduleDay, AccountBranchScheduleStatus, AccountBranchStatus, type AccountDeliveryOption, type AccountDeliveryOptionCalculatedCost, AccountDeliveryOptionPriceLogic, AccountDeliveryOptionStatus, type AccountDeliveryOptionZone, AccountDeliveryOptionZoneStatus, type AccountDomain, AccountDomainStatus, type AccountIntegration, type AccountIntegrationConfigDTO, AccountIntegrationConnectionStatus, AccountIntegrationEnvironment, AccountIntegrationStatus, AccountStatus, type Address, type AdminOrderStatusChangeDto, type BaseEntity, type BaseEntityWithAccount, type BaseEntityWithAccountAndUser, type BaseEntityWithUser, type Cart, type CartConfirmDto, CartDeliveryType, type CartItem, type CartItemAddDto, type CartItemAttributeDetail, CartItemErrorCode, type CartItemRemoveDto, type CartItemUpdateDto, type CartItemValidation, CartSource, CartStatus, type CartUpdateDto, Currency, type Customer, CustomerStatus, type CustomerUpsertDto, type Integration, IntegrationCategory, IntegrationStatus, type MapPosition, type Media, MediaType, type Order, type OrderCreateFromCartDto, OrderDeliveryType, OrderFulfillmentStatus, type OrderItem, OrderPaymentStatus, OrderSource, OrderStatus, type Payment, PaymentMethodType, PaymentStatus, type Phone, type Product, type ProductAttribute, type ProductAttributeOption, ProductAttributeStatus, ProductAttributeType, type ProductCategory, ProductCategoryStatus, ProductStatus, ProductType, type ProductVariant, PubSubTopics, type StandardCategory, StandardCategoryStatus, type StatusChangeHistory, type StoreBanner, StoreBannerStatus, type StorePage, StorePageStatus, StorePageType, type ThemeConfig, getCurrencySymbol };
+declare enum SupportConversationChannel {
+    WEB = "WEB",
+    EMAIL = "EMAIL",
+    WHATSAPP = "WHATSAPP"
+}
+declare enum SupportConversationVisibility {
+    INTERNAL = "INTERNAL",
+    MERCHANT = "MERCHANT"
+}
+declare enum SupportConversationPriority {
+    LOW = "LOW",
+    MEDIUM = "MEDIUM",
+    HIGH = "HIGH",
+    URGENT = "URGENT"
+}
+declare enum SupportConversationStatus {
+    OPEN = "OPEN",
+    CLOSED = "CLOSED",
+    PENDING = "PENDING"
+}
+declare enum SupportConversationMessageDeliveryStatus {
+    QUEUED = "QUEUED",
+    SENT = "SENT",
+    DELIVERED = "DELIVERED",
+    READ = "READ",
+    FAILED = "FAILED"
+}
+declare enum SupportConversationMessageAiAnalysisStatus {
+    PENDING = "PENDING",
+    PROCESSING = "PROCESSING",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED"
+}
+declare enum SupportConversationMessageDirection {
+    INBOUND = "INBOUND",
+    OUTBOUND = "OUTBOUND"
+}
+declare enum SupportConversationMessageSenderType {
+    CUSTOMER = "CUSTOMER",
+    ACCOUNT_USER = "ACCOUNT_USER",
+    ANONYMOUS = "ANONYMOUS",
+    SYSTEM = "SYSTEM",
+    AI = "AI"
+}
+interface SupportConversation {
+    id: string;
+    accountId: string;
+    subject?: string | null;
+    channel: SupportConversationChannel;
+    assigneeId?: string | null;
+    visibility: SupportConversationVisibility;
+    priority: SupportConversationPriority;
+    requiresMerchantAction: boolean;
+    requiresInternalAction: boolean;
+    customerId?: string | null;
+    customerName?: string | null;
+    customerLastname?: string | null;
+    customerEmail?: string | null;
+    customerPhone?: string | null;
+    status: SupportConversationStatus;
+    lastMessageAt?: Date | null;
+    unreadForAgent: number;
+    unreadForCustomer: number;
+    metadata?: Object | null;
+    aiSuggestion?: Object | null;
+    createdAt: Date;
+    updatedAt: Date;
+    deletedAt?: Date | null;
+    account: Account;
+    customer: Customer | null;
+    messages: SupportConversationMessage[];
+}
+interface SupportConversationMessage {
+    id: string;
+    accountId: string;
+    conversationId: string;
+    direction: SupportConversationMessageDirection;
+    senderType: SupportConversationMessageSenderType;
+    senderId?: string | null;
+    body: string;
+    isAiGenerated: boolean;
+    isSystem: boolean;
+    deliveryStatus: SupportConversationMessageDeliveryStatus;
+    requiresAiAnalysis: boolean;
+    aiAnalysisStatus: SupportConversationMessageAiAnalysisStatus;
+    aiAnalyzedAt?: Date | null;
+    externalMessageId?: string | null;
+    externalThreadId?: string | null;
+    attachments?: Array<{
+        url: string;
+        type?: string;
+        name?: string;
+        sizeBytes?: number;
+    }>;
+    metadata?: Object | null;
+    createdAt: Date;
+    updatedAt: Date;
+    deletedAt?: Date | null;
+}
+
+type CreateFulfillmentDto = {
+    accountId: string;
+    orderId: string;
+    accountBranchId: string;
+    carrier: string;
+    items: CreateFulfillmentItemDto[];
+    data?: Record<string, unknown>;
+};
+
+export { type Account, type AccountBranch, type AccountBranchSchedule, AccountBranchScheduleDay, AccountBranchScheduleStatus, AccountBranchStatus, type AccountDeliveryOption, type AccountDeliveryOptionCalculatedCost, AccountDeliveryOptionPriceLogic, AccountDeliveryOptionStatus, type AccountDeliveryOptionZone, AccountDeliveryOptionZoneStatus, type AccountDomain, AccountDomainStatus, type AccountIntegration, type AccountIntegrationConfigDTO, AccountIntegrationConnectionStatus, AccountIntegrationEnvironment, AccountIntegrationStatus, AccountStatus, type Address, type AdminOrderStatusChangeDto, type BaseEntity, type BaseEntityWithAccount, type BaseEntityWithAccountAndUser, type BaseEntityWithUser, type Cart, type CartConfirmDto, CartDeliveryType, type CartItem, type CartItemAddDto, type CartItemAttributeDetail, CartItemErrorCode, type CartItemRemoveDto, type CartItemUpdateDto, type CartItemValidation, CartSource, CartStatus, type CartUpdateDto, type CreateFulfillmentDto, Currency, type Customer, CustomerStatus, type CustomerUpsertDto, type Fulfillment, FulfillmentStatus, type Integration, IntegrationCategory, IntegrationStatus, type MapPosition, type Media, MediaType, type Order, type OrderCreateFromCartDto, OrderDeliveryType, type OrderItem, OrderPaymentStatus, OrderSource, OrderStatus, type Payment, PaymentMethodType, type PaymentProviderAdapter, type PaymentProviderContext, type PaymentProviderInitInput, type PaymentProviderInitOutput, type PaymentProviderKey, type PaymentProviderRefundInput, type PaymentProviderRefundOutput, type PaymentProviderWebhookResult, PaymentStatus, type Phone, type Product, type ProductAttribute, type ProductAttributeOption, ProductAttributeStatus, ProductAttributeType, type ProductCategory, ProductCategoryStatus, ProductStatus, ProductType, type ProductVariant, PubSubTopics, type StandardCategory, StandardCategoryStatus, type StatusChangeHistory, type StoreBanner, StoreBannerStatus, type StorePage, StorePageStatus, StorePageType, type SupportConversation, SupportConversationChannel, type SupportConversationMessage, SupportConversationMessageAiAnalysisStatus, SupportConversationMessageDeliveryStatus, SupportConversationMessageDirection, SupportConversationMessageSenderType, SupportConversationPriority, SupportConversationStatus, SupportConversationVisibility, type ThemeConfig, type WebhookPayload, getCurrencySymbol };