@fiado/type-kit 3.181.0 → 3.183.0

package/src/remittance/enums/RemittanceCancelOutcomeEnum.ts

@@ -1,4 +1,4 @@
-export enum RemittanceCancelOutcomeEnum {
-    VOID = "VOID",     // pre-settlement UNIR → se muestra CANCELLED
-    REFUND = "REFUND", // post-settlement UNIR
-}
+export enum RemittanceCancelOutcomeEnum {
+    VOID = "VOID",     // pre-settlement UNIR → se muestra CANCELLED
+    REFUND = "REFUND", // post-settlement UNIR
+}

package/src/remittance/enums/RemittanceCancelledByEnum.ts

@@ -1,5 +1,5 @@
-export enum RemittanceCancelledByEnum {
-    USER = "USER",
-    SYSTEM = "SYSTEM",
-    // FIADO_ERROR — diferido a fase posterior (sin flujo Fiado que cancele en v1).
-}
+export enum RemittanceCancelledByEnum {
+    USER = "USER",
+    SYSTEM = "SYSTEM",
+    // FIADO_ERROR — diferido a fase posterior (sin flujo Fiado que cancele en v1).
+}

package/src/remittance/enums/RemittanceCorridor.ts

@@ -1,22 +1,22 @@
-/**
- * Corredores de remesa soportados (Dashboard Ops · Variables Operativas).
- *
- * D-PB-3: nomenclatura por MONEDA ISO-4217 (`USD-<destino>`). `USD_SVC` es un
- * símbolo para El Salvador (su payout real es USD; usar la moneda colisionaría
- * como "USD-USD"). Por eso el destino real vive en CORRIDOR_INFO y el filtro de
- * transacciones usa countryISO (no ambiguo).
- */
-export enum RemittanceCorridor {
-    USD_GTQ = "USD-GTQ",
-    USD_MXN = "USD-MXN",
-    USD_HNL = "USD-HNL",
-    USD_SVC = "USD-SVC",
-}
-
-/** Destino real del corredor. El filtro de tx usa countryISO; currencyISO es el payout. */
-export const CORRIDOR_INFO: Record<RemittanceCorridor, { countryISO: string; currencyISO: string }> = {
-    [RemittanceCorridor.USD_GTQ]: { countryISO: "GT", currencyISO: "GTQ" },
-    [RemittanceCorridor.USD_MXN]: { countryISO: "MX", currencyISO: "MXN" },
-    [RemittanceCorridor.USD_HNL]: { countryISO: "HN", currencyISO: "HNL" },
-    [RemittanceCorridor.USD_SVC]: { countryISO: "SV", currencyISO: "USD" },
-};
+/**
+ * Corredores de remesa soportados (Dashboard Ops · Variables Operativas).
+ *
+ * D-PB-3: nomenclatura por MONEDA ISO-4217 (`USD-<destino>`). `USD_SVC` es un
+ * símbolo para El Salvador (su payout real es USD; usar la moneda colisionaría
+ * como "USD-USD"). Por eso el destino real vive en CORRIDOR_INFO y el filtro de
+ * transacciones usa countryISO (no ambiguo).
+ */
+export enum RemittanceCorridor {
+    USD_GTQ = "USD-GTQ",
+    USD_MXN = "USD-MXN",
+    USD_HNL = "USD-HNL",
+    USD_SVC = "USD-SVC",
+}
+
+/** Destino real del corredor. El filtro de tx usa countryISO; currencyISO es el payout. */
+export const CORRIDOR_INFO: Record<RemittanceCorridor, { countryISO: string; currencyISO: string }> = {
+    [RemittanceCorridor.USD_GTQ]: { countryISO: "GT", currencyISO: "GTQ" },
+    [RemittanceCorridor.USD_MXN]: { countryISO: "MX", currencyISO: "MXN" },
+    [RemittanceCorridor.USD_HNL]: { countryISO: "HN", currencyISO: "HNL" },
+    [RemittanceCorridor.USD_SVC]: { countryISO: "SV", currencyISO: "USD" },
+};

package/src/remittance/enums/RemittanceCountryISO.ts

@@ -1,11 +1,11 @@
-/**
- * Países destino habilitados para FIADO en UniTeller (verificado en smoke test 12-may-2026:
- * DestCountries retorna SV, GT, HN, NI para FIADO sandbox; MX no habilitado en sandbox).
- * Mantener como string union para permitir extensión sin breaking change.
- */
-export enum RemittanceCountryISO {
-    GT = "GT",
-    SV = "SV",
-    HN = "HN",
-    MX = "MX",
-}
+/**
+ * Países destino habilitados para FIADO en UniTeller (verificado en smoke test 12-may-2026:
+ * DestCountries retorna SV, GT, HN, NI para FIADO sandbox; MX no habilitado en sandbox).
+ * Mantener como string union para permitir extensión sin breaking change.
+ */
+export enum RemittanceCountryISO {
+    GT = "GT",
+    SV = "SV",
+    HN = "HN",
+    MX = "MX",
+}

package/src/remittance/enums/RemittanceExceptionCode.ts

@@ -1,20 +1,20 @@
-/**
- * Códigos propios ("our-code") de excepciones de remesas. Traducimos los códigos
- * crudos de UNIR a ESTE formato; los crudos NUNCA se exponen. UNKNOWN es el
- * fallback para sub-status/motivos no catalogados (nuevos o desconocidos).
- */
-export enum RemittanceExceptionCode {
-    // HOLD (el proveedor marcó la tx)
-    HOLD_DISPERSAL_UNCONFIRMED = "HOLD_DISPERSAL_UNCONFIRMED",
-    HOLD_PROVIDER_TIMEOUT = "HOLD_PROVIDER_TIMEOUT",
-    HOLD_COMPLIANCE_REVIEW = "HOLD_COMPLIANCE_REVIEW",
-    HOLD_GENERIC = "HOLD_GENERIC",
-    // Cancelación en proceso
-    CANCEL_USER_REQUESTED = "CANCEL_USER_REQUESTED",
-    CANCEL_PROVIDER_INITIATED = "CANCEL_PROVIDER_INITIATED",
-    CANCEL_GENERIC = "CANCEL_GENERIC",
-    // In-process atorada > 24h
-    INPROCESS_STALE_24H = "INPROCESS_STALE_24H",
-    // Fallback
-    UNKNOWN = "UNKNOWN",
-}
+/**
+ * Códigos propios ("our-code") de excepciones de remesas. Traducimos los códigos
+ * crudos de UNIR a ESTE formato; los crudos NUNCA se exponen. UNKNOWN es el
+ * fallback para sub-status/motivos no catalogados (nuevos o desconocidos).
+ */
+export enum RemittanceExceptionCode {
+    // HOLD (el proveedor marcó la tx)
+    HOLD_DISPERSAL_UNCONFIRMED = "HOLD_DISPERSAL_UNCONFIRMED",
+    HOLD_PROVIDER_TIMEOUT = "HOLD_PROVIDER_TIMEOUT",
+    HOLD_COMPLIANCE_REVIEW = "HOLD_COMPLIANCE_REVIEW",
+    HOLD_GENERIC = "HOLD_GENERIC",
+    // Cancelación en proceso
+    CANCEL_USER_REQUESTED = "CANCEL_USER_REQUESTED",
+    CANCEL_PROVIDER_INITIATED = "CANCEL_PROVIDER_INITIATED",
+    CANCEL_GENERIC = "CANCEL_GENERIC",
+    // In-process atorada > 24h
+    INPROCESS_STALE_24H = "INPROCESS_STALE_24H",
+    // Fallback
+    UNKNOWN = "UNKNOWN",
+}

package/src/remittance/enums/RemittanceTxStatus.ts

@@ -1,9 +1,9 @@
-export enum RemittanceTxStatus {
-    IN_PROCESS = "IN_PROCESS",
-    PAYABLE = "PAYABLE",
-    PAID = "PAID",
-    HOLD = "HOLD",
-    CANCELLATION_IN_PROGRESS = "CANCELLATION_IN_PROGRESS", // intermedio: cancel aceptado, esperando settlement + credit-back
-    CANCELLED = "CANCELLED",
-    REFUND = "REFUND",
-}
+export enum RemittanceTxStatus {
+    IN_PROCESS = "IN_PROCESS",
+    PAYABLE = "PAYABLE",
+    PAID = "PAID",
+    HOLD = "HOLD",
+    CANCELLATION_IN_PROGRESS = "CANCELLATION_IN_PROGRESS", // intermedio: cancel aceptado, esperando settlement + credit-back
+    CANCELLED = "CANCELLED",
+    REFUND = "REFUND",
+}

package/src/remittance/enums/RemittanceUserState.ts

@@ -1,11 +1,11 @@
-/**
- * Estado del usuario en el flujo de remesas (response cross-lambda).
- * Distinto del status interno de la tabla `RemittanceUsers_GT` del connector
- * (que solo tiene ACTIVE/SUSPENDED/PENDING). Este es el shape que el mobile consume.
- */
-export enum RemittanceUserState {
-    ONBOARDING_REQUIRED = "ONBOARDING_REQUIRED",
-    ACTIVE = "ACTIVE",
-    SUSPENDED = "SUSPENDED",
-    PENDING_VERIFICATION = "PENDING_VERIFICATION",
-}
+/**
+ * Estado del usuario en el flujo de remesas (response cross-lambda).
+ * Distinto del status interno de la tabla `RemittanceUsers_GT` del connector
+ * (que solo tiene ACTIVE/SUSPENDED/PENDING). Este es el shape que el mobile consume.
+ */
+export enum RemittanceUserState {
+    ONBOARDING_REQUIRED = "ONBOARDING_REQUIRED",
+    ACTIVE = "ACTIVE",
+    SUSPENDED = "SUSPENDED",
+    PENDING_VERIFICATION = "PENDING_VERIFICATION",
+}

package/src/remittance/enums/RuleActionType.ts

@@ -1,9 +1,9 @@
-/** Acción cuando la condición se rompe. */
-export enum RuleActionType {
-    /** Fuerza al valor permitido (el valor de la condición) y procede. Solo caps clampeables, per-tx. */
-    FORCE_LIMIT = "FORCE_LIMIT",
-    /** Bloquea el guardado / rechaza la tx. */
-    BLOCK = "BLOCK",
-    /** Permite pero notifica a un comité. Exclusivo de ALARM. */
-    NOTIFY = "NOTIFY",
-}
+/** Acción cuando la condición se rompe. */
+export enum RuleActionType {
+    /** Fuerza al valor permitido (el valor de la condición) y procede. Solo caps clampeables, per-tx. */
+    FORCE_LIMIT = "FORCE_LIMIT",
+    /** Bloquea el guardado / rechaza la tx. */
+    BLOCK = "BLOCK",
+    /** Permite pero notifica a un comité. Exclusivo de ALARM. */
+    NOTIFY = "NOTIFY",
+}

package/src/remittance/enums/RuleCategory.ts

@@ -1,9 +1,9 @@
-/** Categoría de la regla (Variables Operativas › Reglas — mockup). */
-export enum RuleCategory {
-    /** Límite duro: fuerza al valor permitido (per-tx) o bloquea el save de config. */
-    CAP = "CAP",
-    /** Bloquea el guardado si la condición se rompe. */
-    VALIDATION = "VALIDATION",
-    /** Permite pero notifica al comité correspondiente. */
-    ALARM = "ALARM",
-}
+/** Categoría de la regla (Variables Operativas › Reglas — mockup). */
+export enum RuleCategory {
+    /** Límite duro: fuerza al valor permitido (per-tx) o bloquea el save de config. */
+    CAP = "CAP",
+    /** Bloquea el guardado si la condición se rompe. */
+    VALIDATION = "VALIDATION",
+    /** Permite pero notifica al comité correspondiente. */
+    ALARM = "ALARM",
+}

package/src/remittance/enums/RuleField.ts

@@ -1,13 +1,13 @@
-/**
- * Campo de la condición (los 6 del mockup). Todos numéricos. "efectivo" = después
- * de aplicar promos. TAKE_RATE es "Spread efectivo" redefinido (D-RG-1):
- * MU + round(fee/monto × 10000) = cuánto le saca Fiado al cliente EN TOTAL.
- */
-export enum RuleField {
-    FEE_EFFECTIVE = "FEE_EFFECTIVE",             // USD
-    MU_EFFECTIVE = "MU_EFFECTIVE",               // bps
-    TAKE_RATE = "TAKE_RATE",                     // bps
-    TX_AMOUNT = "TX_AMOUNT",                      // USD — solo por tx (Fase B)
-    MU_CHANGE_24H = "MU_CHANGE_24H",             // % — solo alarma, config-save
-    PROMO_VOLUME_SHARE = "PROMO_VOLUME_SHARE",   // % — solo alarma, Fase B (cron)
-}
+/**
+ * Campo de la condición (los 6 del mockup). Todos numéricos. "efectivo" = después
+ * de aplicar promos. TAKE_RATE es "Spread efectivo" redefinido (D-RG-1):
+ * MU + round(fee/monto × 10000) = cuánto le saca Fiado al cliente EN TOTAL.
+ */
+export enum RuleField {
+    FEE_EFFECTIVE = "FEE_EFFECTIVE",             // USD
+    MU_EFFECTIVE = "MU_EFFECTIVE",               // bps
+    TAKE_RATE = "TAKE_RATE",                     // bps
+    TX_AMOUNT = "TX_AMOUNT",                      // USD — solo por tx (Fase B)
+    MU_CHANGE_24H = "MU_CHANGE_24H",             // % — solo alarma, config-save
+    PROMO_VOLUME_SHARE = "PROMO_VOLUME_SHARE",   // % — solo alarma, Fase B (cron)
+}

package/src/remittance/enums/RuleOperator.ts

@@ -1,7 +1,7 @@
-/** Operadores de la condición: SOLO de orden (con 6 campos numéricos, ==/in no aportan y "forzar al límite" exige orden). */
-export enum RuleOperator {
-    GT = ">",
-    GTE = ">=",
-    LT = "<",
-    LTE = "<=",
-}
+/** Operadores de la condición: SOLO de orden (con 6 campos numéricos, ==/in no aportan y "forzar al límite" exige orden). */
+export enum RuleOperator {
+    GT = ">",
+    GTE = ">=",
+    LT = "<",
+    LTE = "<=",
+}

package/src/remittance/enums/SegmentMemberType.ts

@@ -1,8 +1,8 @@
-/**
- * Tipo de miembro de la composición de un segmento (Dashboard Ops · Configuración §2).
- * Los valores son los del mockup (pills GRUPO/TAG del dual-list).
- */
-export enum SegmentMemberType {
-    GROUP = "group",
-    TAG = "tag",
-}
+/**
+ * Tipo de miembro de la composición de un segmento (Dashboard Ops · Configuración §2).
+ * Los valores son los del mockup (pills GRUPO/TAG del dual-list).
+ */
+export enum SegmentMemberType {
+    GROUP = "group",
+    TAG = "tag",
+}

package/src/remittance/enums/index.ts

@@ -1,25 +1,25 @@
-export * from "./ReceptionMethod";
-export * from "./RemittanceTxStatus";
-export * from "./RemittanceCountryISO";
-export * from "./RemittanceUserState";
-export * from "./RemittanceCancelledByEnum";
-export * from "./RemittanceCancelOutcomeEnum";
-export * from "./FeeAbsorbedByEnum";
-export * from "./CohortField";
-export * from "./CohortOperator";
-export * from "./CohortRefresh";
-export * from "./AuditAction";
-export * from "./AuditEntityType";
-export * from "./SegmentMemberType";
-export * from "./RemittanceCorridor";
-export * from "./PromotionKind";
-export * from "./PromotionActivation";
-export * from "./PromotionStatus";
-export * from "./FxEffectMode";
-export * from "./FeeEffectMode";
-export * from "./RuleCategory";
-export * from "./RuleField";
-export * from "./RuleOperator";
-export * from "./RuleActionType";
-export * from "./AuditResult";
-export * from "./RemittanceExceptionCode";
+export * from "./ReceptionMethod";
+export * from "./RemittanceTxStatus";
+export * from "./RemittanceCountryISO";
+export * from "./RemittanceUserState";
+export * from "./RemittanceCancelledByEnum";
+export * from "./RemittanceCancelOutcomeEnum";
+export * from "./FeeAbsorbedByEnum";
+export * from "./CohortField";
+export * from "./CohortOperator";
+export * from "./CohortRefresh";
+export * from "./AuditAction";
+export * from "./AuditEntityType";
+export * from "./SegmentMemberType";
+export * from "./RemittanceCorridor";
+export * from "./PromotionKind";
+export * from "./PromotionActivation";
+export * from "./PromotionStatus";
+export * from "./FxEffectMode";
+export * from "./FeeEffectMode";
+export * from "./RuleCategory";
+export * from "./RuleField";
+export * from "./RuleOperator";
+export * from "./RuleActionType";
+export * from "./AuditResult";
+export * from "./RemittanceExceptionCode";

package/src/remittance/index.ts

@@ -1,13 +1,13 @@
-// Enums
-export * from "./enums";
-// DTOs
-export * from "./dtos";
-export * from "./dtos/internal/RemittanceCreditBackRequest";
-export * from "./dtos/internal/RemittanceCreditBackResponse";
-export * from "./dtos/internal/RemittanceCohortCount";
-export * from "./dtos/internal/RemittanceSegmentMetrics";
-export * from "./dtos/internal/RemittancePricingBridge";
-export * from "./dtos/internal/RemittancePromotionReach";
-export * from "./dtos/internal/RemittancePricingResolve";
-export * from "./dtos/internal/RemittancePricingSchedule";
-export * from "./dtos/internal/RemittanceCohortUserMatch";
+// Enums
+export * from "./enums";
+// DTOs
+export * from "./dtos";
+export * from "./dtos/internal/RemittanceCreditBackRequest";
+export * from "./dtos/internal/RemittanceCreditBackResponse";
+export * from "./dtos/internal/RemittanceCohortCount";
+export * from "./dtos/internal/RemittanceSegmentMetrics";
+export * from "./dtos/internal/RemittancePricingBridge";
+export * from "./dtos/internal/RemittancePromotionReach";
+export * from "./dtos/internal/RemittancePricingResolve";
+export * from "./dtos/internal/RemittancePricingSchedule";
+export * from "./dtos/internal/RemittanceCohortUserMatch";

package/src/retailOrg/dtos/GeoLocation.ts

@@ -0,0 +1,20 @@
+import { Expose } from 'class-transformer';
+import { IsNumber } from 'class-validator';
+
+/**
+ * Coordenada geográfica (punto) de una tienda física SureKeep.
+ *
+ * Value-object de coordenadas — NO es una dirección postal. En el dominio `address` no existe
+ * un tipo `{ lat: number; lng: number }` numérico reutilizable (`Geometry` es una tupla
+ * `[number, number]` y `Location.latitude/longitude` son strings), por lo que se define acá
+ * con el shape exacto que pide el contrato F1 (ambos campos obligatorios).
+ */
+export class GeoLocation {
+    @Expose()
+    @IsNumber()
+    lat!: number;
+
+    @Expose()
+    @IsNumber()
+    lng!: number;
+}

package/src/retailOrg/dtos/PaginatedResult.ts

@@ -0,0 +1,10 @@
+/**
+ * Resultado paginado genérico para los listados del dominio retail-org-business.
+ * `nextToken` es el cursor opaco de DynamoDB (ausente en la última página).
+ * `count` es la cantidad de items en ESTA página (no el total del dataset).
+ */
+export interface PaginatedResult<T> {
+    items: T[];
+    nextToken?: string;
+    count: number;
+}

package/src/retailOrg/dtos/RetailUser.ts

@@ -0,0 +1,63 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional, IsString, Matches } from 'class-validator';
+import { regexIso8601 } from '../../helpers/constans/regex';
+import { EmploymentTypeEnum } from '../enums/EmploymentTypeEnum';
+import { RetailUserStatusEnum } from '../enums/RetailUserStatusEnum';
+
+/**
+ * RetailUser — usuario retail (empleado de tienda) de un retailer (SureKeep Fase 1 — pista Retail).
+ * `cognitoSub` enlaza con la identidad en Cognito (validada vía platform-rbac por api-invoker).
+ */
+export class RetailUser {
+    @Expose()
+    @IsString()
+    retailUserId!: string;
+
+    @Expose()
+    @IsString()
+    cognitoSub!: string;
+
+    @Expose()
+    @IsString()
+    retailerId!: string;
+
+    @Expose()
+    @IsString()
+    homeStoreId!: string;
+
+    /** Zona de operación del usuario; `null` si no está acotado a una zona. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    zoneId!: string | null;
+
+    @Expose()
+    @IsEnum(EmploymentTypeEnum)
+    employmentType!: EmploymentTypeEnum;
+
+    @Expose()
+    @IsString()
+    commissionTier!: string;
+
+    @Expose()
+    @IsEnum(RetailUserStatusEnum)
+    status!: RetailUserStatusEnum;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'createdAt debe ser una fecha ISO 8601' })
+    createdAt!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'updatedAt debe ser una fecha ISO 8601' })
+    updatedAt!: string;
+
+    @Expose()
+    @IsString()
+    createdBy!: string;
+
+    @Expose()
+    @IsString()
+    updatedBy!: string;
+}

package/src/retailOrg/dtos/Retailer.ts

@@ -0,0 +1,81 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEmail, IsEnum, IsObject, IsString, Length, Matches } from 'class-validator';
+import { LocationAddress } from '../../address/dtos/LocationAddress';
+import { regexIso8601 } from '../../helpers/constans/regex';
+import { RetailerStatusEnum } from '../enums/RetailerStatusEnum';
+import { RetailerTypeEnum } from '../enums/RetailerTypeEnum';
+
+/**
+ * Retailer — nodo raíz de la organización comercial SureKeep (cadena / subdistribuidor / franquicia).
+ * Entidad completa del dominio retail-org-business (SureKeep Fase 1 — pista Retail).
+ *
+ * El campo `address` reutiliza `LocationAddress` del dominio `address` (representación de dirección
+ * provider-agnóstica del repo). Ver DEC del proyecto: `AddressBase` se descartó por estar acoplado
+ * al modelo directory/customer de Fiado core (exige `directoryId`, `tenantId`, `typeOfDirectoryId`,
+ * `provider`, `isPrincipal`…), inadecuado para una dirección comercial.
+ */
+export class Retailer {
+    @Expose()
+    @IsString()
+    retailerId!: string;
+
+    /** 'ROOT' para el nodo raíz, o el `retailerId` del padre. */
+    @Expose()
+    @IsString()
+    parentId!: string;
+
+    @Expose()
+    @IsEnum(RetailerTypeEnum)
+    type!: RetailerTypeEnum;
+
+    @Expose()
+    @IsString()
+    name!: string;
+
+    @Expose()
+    @IsString()
+    legalName!: string;
+
+    /** RFC mexicano — 12 caracteres (persona moral / empresa) o 13 (persona física). */
+    @Expose()
+    @IsString()
+    @Length(12, 13)
+    rfc!: string;
+
+    @Expose()
+    @IsEmail()
+    contactEmail!: string;
+
+    @Expose()
+    @IsString()
+    contactPhone!: string;
+
+    // LocationAddress no expone decoradores class-validator, por lo que no se usa @ValidateNested
+    // (dispararía "unknown value"); @IsObject exige presencia + shape objeto y @Type lo hidrata.
+    @Expose()
+    @IsObject()
+    @Type(() => LocationAddress)
+    address!: LocationAddress;
+
+    @Expose()
+    @IsEnum(RetailerStatusEnum)
+    status!: RetailerStatusEnum;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'createdAt debe ser una fecha ISO 8601' })
+    createdAt!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'updatedAt debe ser una fecha ISO 8601' })
+    updatedAt!: string;
+
+    @Expose()
+    @IsString()
+    createdBy!: string;
+
+    @Expose()
+    @IsString()
+    updatedBy!: string;
+}

package/src/retailOrg/dtos/Store.ts

@@ -0,0 +1,105 @@
+import { Expose, Type } from 'class-transformer';
+import {
+    IsDefined,
+    IsEnum,
+    IsNumber,
+    IsObject,
+    IsOptional,
+    IsString,
+    Length,
+    Matches,
+    ValidateNested,
+} from 'class-validator';
+import { LocationAddress } from '../../address/dtos/LocationAddress';
+import { regexIso8601 } from '../../helpers/constans/regex';
+import { StoreStatusEnum } from '../enums/StoreStatusEnum';
+import { GeoLocation } from './GeoLocation';
+
+/**
+ * Store — tienda física de un retailer (SureKeep Fase 1 — pista Retail).
+ *
+ * `address` reutiliza `LocationAddress` (ver DEC del proyecto sobre el descarte de `AddressBase`).
+ * `location` (coordenada `{ lat, lng }`) es OBLIGATORIA.
+ */
+export class Store {
+    @Expose()
+    @IsString()
+    storeId!: string;
+
+    @Expose()
+    @IsString()
+    retailerId!: string;
+
+    /** Zona a la que pertenece la tienda; `null` si aún no está asignada a una zona. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    zoneId!: string | null;
+
+    /** Código interno de la tienda — máximo 10 caracteres. */
+    @Expose()
+    @IsString()
+    @Length(1, 10)
+    code!: string;
+
+    @Expose()
+    @IsString()
+    name!: string;
+
+    // LocationAddress no expone decoradores class-validator (no @ValidateNested — dispararía
+    // "unknown value"); @IsObject exige presencia + shape objeto y @Type lo hidrata.
+    @Expose()
+    @IsObject()
+    @Type(() => LocationAddress)
+    address!: LocationAddress;
+
+    @Expose()
+    @IsDefined()
+    @ValidateNested()
+    @Type(() => GeoLocation)
+    location!: GeoLocation;
+
+    @Expose()
+    @IsString()
+    phone!: string;
+
+    /** Usuario retail responsable de la tienda; `null` si no hay gerente asignado. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    managerRetailUserId!: string | null;
+
+    /** Horario operativo (texto libre); `null` si no está definido. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    schedule!: string | null;
+
+    /** Venta diaria promedio en centavos; `null` si no está registrada. */
+    @Expose()
+    @IsOptional()
+    @IsNumber()
+    dailyAvgSalesCents!: number | null;
+
+    @Expose()
+    @IsEnum(StoreStatusEnum)
+    status!: StoreStatusEnum;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'createdAt debe ser una fecha ISO 8601' })
+    createdAt!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'updatedAt debe ser una fecha ISO 8601' })
+    updatedAt!: string;
+
+    @Expose()
+    @IsString()
+    createdBy!: string;
+
+    @Expose()
+    @IsString()
+    updatedBy!: string;
+}