@fiado/type-kit 3.495.0 → 3.496.0

package/src/retailIntegration/models/RetailSystemProduct.ts

@@ -0,0 +1,43 @@
+import {
+    RetailCurrencyEnum,
+    RetailFinancierEnum,
+    RetailMdmProviderEnum,
+    RetailProductCategoryEnum,
+    RetailProductStatusEnum,
+    RetailProductTierEnum,
+    RetailTrackingModeEnum,
+} from '../enums';
+
+export type RetailProductCategory = `${RetailProductCategoryEnum}`;
+export type RetailTrackingMode = `${RetailTrackingModeEnum}`;
+export type RetailProductTier = `${RetailProductTierEnum}`;
+export type RetailCurrency = `${RetailCurrencyEnum}`;
+export type RetailFinancier = `${RetailFinancierEnum}`;
+export type RetailMdmProvider = `${RetailMdmProviderEnum}`;
+export type RetailProductStatus = `${RetailProductStatusEnum}`;
+
+/** Precios como decimal en string con dos decimales. */
+export interface RetailSystemProductPrice {
+    basePrice: string;
+    listPrice: string | null;
+    effectiveFrom: string;
+}
+
+/** Producto tal como lo define la doc de integración. */
+export interface RetailSystemProduct {
+    sku: string;
+    externalId: string;
+    brand: string;
+    model: string;
+    color: string | null;
+    capacity: string | null;
+    description: string | null;
+    category: RetailProductCategory;
+    trackingMode: RetailTrackingMode;
+    tier: RetailProductTier | null;
+    currencyId: RetailCurrency;
+    price: RetailSystemProductPrice;
+    eligibleFinanciers: RetailFinancier[];
+    mdmProvider: RetailMdmProvider | null;
+    status: RetailProductStatus;
+}

package/src/retailIntegration/models/RetailSystemSale.ts

@@ -0,0 +1,51 @@
+import { RetailLinePaymentTypeEnum, RetailPaymentMethodEnum, RetailSaleFinancierEnum, RetailSaleTypeEnum } from '../enums';
+import { RetailCurrency } from './RetailSystemProduct';
+
+export type RetailSaleType = `${RetailSaleTypeEnum}`;
+export type RetailSaleFinancier = `${RetailSaleFinancierEnum}`;
+export type RetailPaymentMethod = `${RetailPaymentMethodEnum}`;
+export type RetailLinePaymentType = `${RetailLinePaymentTypeEnum}`;
+
+export interface RetailSystemSaleCustomer {
+    customerId: string;
+    names: string;
+    paternalLastName: string;
+    maternalLastName: string | null;
+    phone: string;
+}
+
+export interface RetailSystemSaleComponent {
+    sku: string;
+    qty: number;
+    identifiers: string[];
+}
+
+export interface RetailSystemSaleLine {
+    lineId: string;
+    sku: string;
+    qty: number;
+    basePrice: string;
+    discount: string;
+    paymentType: RetailLinePaymentType;
+    financedAmount: string;
+    role: 'GIFT' | null;
+    components: RetailSystemSaleComponent[];
+}
+
+/** Cuerpo de `POST /sales` de la doc; `saleId` es la llave de idempotencia. */
+export interface RetailSystemSale {
+    saleId: string;
+    folio: string;
+    storeId: string;
+    sellerRetailUserId: string;
+    soldAt: string;
+    saleType: RetailSaleType;
+    financier: RetailSaleFinancier;
+    creditId: string | null;
+    currencyId: RetailCurrency;
+    customer: RetailSystemSaleCustomer;
+    equipmentPrice: string;
+    amountPaid: string;
+    paymentMethod: RetailPaymentMethod | null;
+    lines: RetailSystemSaleLine[];
+}

package/src/retailIntegration/models/RetailSystemStore.ts

@@ -0,0 +1,33 @@
+import { RetailStoreStatusEnum } from '../enums';
+
+export type RetailStoreStatus = `${RetailStoreStatusEnum}`;
+
+export interface RetailSystemStoreAddress {
+    address1: string;
+    externalNumber: string | null;
+    internalNumber: string | null;
+    neighborhood: string | null;
+    city: string;
+    state: string;
+    zipCode: string;
+    country: string | null;
+    reference: string | null;
+}
+
+export interface RetailSystemStoreLocation {
+    lat: number | null;
+    lng: number | null;
+}
+
+/** Tienda tal como la define la doc de integración. */
+export interface RetailSystemStore {
+    storeId: string;
+    code: string;
+    name: string;
+    zoneId: string | null;
+    address: RetailSystemStoreAddress;
+    location: RetailSystemStoreLocation;
+    phone: string;
+    schedule: string | null;
+    status: RetailStoreStatus;
+}

package/src/retailIntegration/models/RetailSystemUser.ts

@@ -0,0 +1,16 @@
+import { RetailUserAccessStatusEnum, RetailUserRoleEnum } from '../enums';
+
+export type RetailUserRole = `${RetailUserRoleEnum}`;
+export type RetailUserAccessStatus = `${RetailUserAccessStatusEnum}`;
+
+/** Usuario de la operación del retailer, tal como lo define la doc de integración. */
+export interface RetailSystemUser {
+    retailUserId: string;
+    displayName: string;
+    email: string;
+    phone: string | null;
+    homeStoreId: string;
+    zoneId: string | null;
+    role: RetailUserRole;
+    status: RetailUserAccessStatus;
+}

package/src/retailIntegration/validators/IsIsoDateTimeWithZone.ts

@@ -0,0 +1,21 @@
+import { ValidatorConstraint, ValidatorConstraintInterface } from 'class-validator';
+
+const ISO_DATE_TIME_WITH_ZONE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,9})?(Z|[+-]\d{2}:\d{2})$/;
+
+/** Descarta fechas que `Date` recorre en silencio, como el 31 de febrero. */
+function isRealCalendarDate(value: string): boolean {
+    const [year, month, day] = value.slice(0, 10).split('-').map(Number);
+    return !Number.isNaN(Date.parse(value)) && new Date(Date.UTC(year, month - 1, day)).getUTCDate() === day;
+}
+
+/** Acepta fecha y hora ISO-8601 con segundos y zona; sin zona se rechaza, como dice la doc. */
+@ValidatorConstraint({ name: 'isIsoDateTimeWithZone', async: false })
+export class IsIsoDateTimeWithZone implements ValidatorConstraintInterface {
+    validate(value: unknown): boolean {
+        return typeof value === 'string' && ISO_DATE_TIME_WITH_ZONE.test(value) && isRealCalendarDate(value);
+    }
+
+    defaultMessage(): string {
+        return 'debe ser fecha y hora ISO-8601 con zona, por ejemplo 2026-08-17T20:32:05Z';
+    }
+}