@fiado/type-kit 3.379.0 → 3.381.0

package/bin/loanOfferings/dtos/requests/ChangeSegmentStatusRequest.d.ts

@@ -0,0 +1,10 @@
+import { SegmentStatusEnum } from '../../enums/SegmentStatusEnum';
+/**
+ * Body de PUT /segments/:segmentId/status — archiva o reactiva un segmento.
+ * No hay borrado: archivar lo saca del motor y de los selectores sin dejar huérfanas a las
+ * políticas y promociones que le apuntan. `reason` queda en la bitácora.
+ */
+export declare class ChangeSegmentStatusRequest {
+    status: SegmentStatusEnum;
+    reason?: string;
+}

package/bin/loanOfferings/dtos/requests/ChangeSegmentStatusRequest.js

@@ -0,0 +1,35 @@
+"use strict";
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChangeSegmentStatusRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const SegmentStatusEnum_1 = require("../../enums/SegmentStatusEnum");
+/**
+ * Body de PUT /segments/:segmentId/status — archiva o reactiva un segmento.
+ * No hay borrado: archivar lo saca del motor y de los selectores sin dejar huérfanas a las
+ * políticas y promociones que le apuntan. `reason` queda en la bitácora.
+ */
+class ChangeSegmentStatusRequest {
+}
+exports.ChangeSegmentStatusRequest = ChangeSegmentStatusRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(SegmentStatusEnum_1.SegmentStatusEnum),
+    __metadata("design:type", String)
+], ChangeSegmentStatusRequest.prototype, "status", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(280),
+    __metadata("design:type", String)
+], ChangeSegmentStatusRequest.prototype, "reason", void 0);

package/bin/loanOfferings/dtos/requests/CreateSegmentRequest.d.ts

@@ -0,0 +1,24 @@
+import { SegmentColorSlotEnum } from '../../enums/SegmentColorSlotEnum';
+/**
+ * Body de POST /segments — alta de un segmento de clientes.
+ * Nace en `ACTIVE`: `segmentId`, `status`, `version`, `isDefault` y la auditoría los asigna el
+ * lambda y NO viajan en el request. Que cada filtro exista en el catálogo y tenga fuente lo valida
+ * el lambda contra `GET /segments/filters`.
+ */
+export declare class CreateSegmentRequest {
+    name: string;
+    description?: string;
+    /** Ranura de color del chip. Ausente = `slate`. */
+    colorSlot?: SegmentColorSlotEnum;
+    /**
+     * Filtros del catálogo cerrado. Un cliente pertenece si cumple AL MENOS UNO — es un OR, no un
+     * AND. Se valida contra el catálogo en el lambda (422), no acá, para poder nombrar el filtro
+     * desconocido y el que todavía no tiene fuente.
+     */
+    filterIds?: string[];
+    /**
+     * Clientes agregados a mano por `retailCustomerId`. Ganan siempre, cumplan o no un filtro.
+     * Un segmento puede nacer SOLO con esta lista, sin ningún filtro activo.
+     */
+    memberIds?: string[];
+}

package/bin/loanOfferings/dtos/requests/CreateSegmentRequest.js

@@ -0,0 +1,57 @@
+"use strict";
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateSegmentRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const SegmentColorSlotEnum_1 = require("../../enums/SegmentColorSlotEnum");
+/**
+ * Body de POST /segments — alta de un segmento de clientes.
+ * Nace en `ACTIVE`: `segmentId`, `status`, `version`, `isDefault` y la auditoría los asigna el
+ * lambda y NO viajan en el request. Que cada filtro exista en el catálogo y tenga fuente lo valida
+ * el lambda contra `GET /segments/filters`.
+ */
+class CreateSegmentRequest {
+}
+exports.CreateSegmentRequest = CreateSegmentRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(120),
+    __metadata("design:type", String)
+], CreateSegmentRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], CreateSegmentRequest.prototype, "description", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(SegmentColorSlotEnum_1.SegmentColorSlotEnum),
+    __metadata("design:type", String)
+], CreateSegmentRequest.prototype, "colorSlot", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], CreateSegmentRequest.prototype, "filterIds", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], CreateSegmentRequest.prototype, "memberIds", void 0);

package/bin/loanOfferings/dtos/requests/CreateStorePolicyRequest.d.ts

@@ -32,6 +32,8 @@ export declare class CreateStorePolicyRequest {
     storeIds?: string[];
     /** Alcance: niveles alcanzados. Ausente = todos los niveles. */
     targetLevels?: CreditPlanLevelEnum[];
+    /** Alcance: segmentos alcanzados. Ausente = todos los segmentos. */
+    segmentIds?: string[];
     /** Alcance: SKUs alcanzados. Ausente = todos los productos. */
     targetSkus?: string[];
     validFrom?: string;

package/bin/loanOfferings/dtos/requests/CreateStorePolicyRequest.js

@@ -140,6 +140,14 @@ __decorate([
     (0, class_validator_1.IsEnum)(CreditPlanLevelEnum_1.CreditPlanLevelEnum, { each: true }),
     __metadata("design:type", Array)
 ], CreateStorePolicyRequest.prototype, "targetLevels", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], CreateStorePolicyRequest.prototype, "segmentIds", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/loanOfferings/dtos/requests/ResolveCustomerSegmentsRequest.d.ts

@@ -0,0 +1,24 @@
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+/**
+ * Body de POST /private/segments/resolve — los hechos del cliente contra los que se evalúan los
+ * filtros. Los junta quien ya tiene al cliente delante (el wizard o el motor de crédito); este
+ * lambda no sale a buscarlos a otro silo en el camino caliente.
+ *
+ * Un hecho AUSENTE hace que su filtro NO se cumpla: sin el dato no se puede afirmar que el cliente
+ * califica, y de las dos salidas la segura es dejarlo fuera.
+ */
+export declare class ResolveCustomerSegmentsRequest {
+    retailCustomerId: string;
+    /** Colaborador de la red. Hoy ningún sistema lo produce — ver la lista de individuos. */
+    isEmployee?: boolean;
+    /** Nivel que resolvió loan-scoring a partir del SCI. */
+    sciLevel?: CreditPlanLevelEnum;
+    /** Créditos cerrados en toda la vida del cliente. */
+    completedCredits?: number;
+    /** Días de mora acumulados en la ventana de 180 días. `0` es sin mora. */
+    delinquencyDaysLast6M?: number;
+    /** Bajas contables vitalicias. `0` es ninguna. */
+    lifetimeWriteOffs?: number;
+    /** Reestructuras vitalicias. `0` es ninguna. */
+    lifetimeRestructures?: number;
+}

package/bin/loanOfferings/dtos/requests/ResolveCustomerSegmentsRequest.js

@@ -0,0 +1,71 @@
+"use strict";
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResolveCustomerSegmentsRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
+/**
+ * Body de POST /private/segments/resolve — los hechos del cliente contra los que se evalúan los
+ * filtros. Los junta quien ya tiene al cliente delante (el wizard o el motor de crédito); este
+ * lambda no sale a buscarlos a otro silo en el camino caliente.
+ *
+ * Un hecho AUSENTE hace que su filtro NO se cumpla: sin el dato no se puede afirmar que el cliente
+ * califica, y de las dos salidas la segura es dejarlo fuera.
+ */
+class ResolveCustomerSegmentsRequest {
+}
+exports.ResolveCustomerSegmentsRequest = ResolveCustomerSegmentsRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ResolveCustomerSegmentsRequest.prototype, "retailCustomerId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], ResolveCustomerSegmentsRequest.prototype, "isEmployee", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(CreditPlanLevelEnum_1.CreditPlanLevelEnum),
+    __metadata("design:type", String)
+], ResolveCustomerSegmentsRequest.prototype, "sciLevel", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], ResolveCustomerSegmentsRequest.prototype, "completedCredits", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], ResolveCustomerSegmentsRequest.prototype, "delinquencyDaysLast6M", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], ResolveCustomerSegmentsRequest.prototype, "lifetimeWriteOffs", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], ResolveCustomerSegmentsRequest.prototype, "lifetimeRestructures", void 0);

package/bin/loanOfferings/dtos/requests/SimulateCreditPlanRequest.d.ts

@@ -16,4 +16,9 @@ export declare class SimulateCreditPlanRequest {
     storeId?: string;
     /** SKU del equipo. Sin él no se resuelven las promociones acotadas por producto. */
     productSku?: string;
+    /**
+     * Segmentos del cliente, los que devolvió `POST /private/segments/resolve`. Un arreglo vacío
+     * declara que el cliente no está en ninguno; ausente declara que el caller no lo consultó.
+     */
+    customerSegmentIds?: string[];
 }

package/bin/loanOfferings/dtos/requests/SimulateCreditPlanRequest.js

@@ -63,3 +63,10 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], SimulateCreditPlanRequest.prototype, "productSku", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], SimulateCreditPlanRequest.prototype, "customerSegmentIds", void 0);

package/bin/loanOfferings/dtos/requests/UpdateSegmentRequest.d.ts

@@ -0,0 +1,18 @@
+import { SegmentColorSlotEnum } from '../../enums/SegmentColorSlotEnum';
+/**
+ * Body de PUT /segments/:segmentId — edición parcial (todos los campos opcionales). Sube `version`.
+ * El cambio de estado va por su endpoint dedicado.
+ *
+ * Un arreglo vacío VACÍA la lista; ausente la deja como está. El segmento por omisión
+ * (`isDefault`) solo acepta el cambio de nombre.
+ */
+export declare class UpdateSegmentRequest {
+    name?: string;
+    description?: string;
+    colorSlot?: SegmentColorSlotEnum;
+    /** Reemplaza la lista entera; `[]` deja el segmento sin filtros. */
+    filterIds?: string[];
+    /** Reemplaza la lista entera; `[]` saca a todos los agregados a mano. */
+    memberIds?: string[];
+    reason?: string;
+}

package/bin/loanOfferings/dtos/requests/UpdateSegmentRequest.js

@@ -0,0 +1,66 @@
+"use strict";
+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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateSegmentRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const SegmentColorSlotEnum_1 = require("../../enums/SegmentColorSlotEnum");
+/**
+ * Body de PUT /segments/:segmentId — edición parcial (todos los campos opcionales). Sube `version`.
+ * El cambio de estado va por su endpoint dedicado.
+ *
+ * Un arreglo vacío VACÍA la lista; ausente la deja como está. El segmento por omisión
+ * (`isDefault`) solo acepta el cambio de nombre.
+ */
+class UpdateSegmentRequest {
+}
+exports.UpdateSegmentRequest = UpdateSegmentRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(120),
+    __metadata("design:type", String)
+], UpdateSegmentRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], UpdateSegmentRequest.prototype, "description", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(SegmentColorSlotEnum_1.SegmentColorSlotEnum),
+    __metadata("design:type", String)
+], UpdateSegmentRequest.prototype, "colorSlot", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], UpdateSegmentRequest.prototype, "filterIds", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], UpdateSegmentRequest.prototype, "memberIds", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(280),
+    __metadata("design:type", String)
+], UpdateSegmentRequest.prototype, "reason", void 0);

package/bin/loanOfferings/dtos/requests/UpdateStorePolicyRequest.d.ts

@@ -14,6 +14,8 @@ export declare class UpdateStorePolicyRequest {
     allowedSkus?: string[];
     storeIds?: string[];
     targetLevels?: CreditPlanLevelEnum[];
+    /** Alcance: segmentos alcanzados. */
+    segmentIds?: string[];
     targetSkus?: string[];
     validFrom?: string;
     validUntil?: string;

package/bin/loanOfferings/dtos/requests/UpdateStorePolicyRequest.js

@@ -80,6 +80,14 @@ __decorate([
     (0, class_validator_1.IsEnum)(CreditPlanLevelEnum_1.CreditPlanLevelEnum, { each: true }),
     __metadata("design:type", Array)
 ], UpdateStorePolicyRequest.prototype, "targetLevels", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], UpdateStorePolicyRequest.prototype, "segmentIds", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/loanOfferings/dtos/responses/PromotedSkusResponse.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SKUs que hoy traen promoción en una tienda, para el badge del catálogo del wizard.
+ *
+ * El catálogo se pinta en el paso 03 y el nivel del cliente recién sale en el paso 05, así que la
+ * lista solo incluye promociones que alcanzan a CUALQUIER nivel: una acotada por nivel prometería
+ * un beneficio que la cotización puede no dar, y el vendedor ya se lo dijo al cliente.
+ *
+ * Solo entran las promociones que ACOTAN por SKU. Una promoción de «todos los productos» no es una
+ * propiedad del equipo y marcaría el catálogo entero, que es lo mismo que no marcar nada.
+ */
+export interface PromotedSkusResponse {
+    /** SKUs con al menos una promoción vigente que los nombra. Vacío si no hay ninguna. */
+    skus: string[];
+}

package/bin/loanOfferings/dtos/responses/PromotedSkusResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanOfferings/dtos/responses/ResolveCustomerSegmentsResponse.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Respuesta de POST /private/segments/resolve: los segmentos a los que pertenece el cliente HOY.
+ *
+ * Puede venir VACÍO, y eso no es un error: «estar en Estándar» es justamente no pertenecer a
+ * ningún segmento preferente. El segmento por omisión NUNCA se devuelve acá.
+ */
+export interface ResolveCustomerSegmentsResponse {
+    retailCustomerId: string;
+    segmentIds: string[];
+}

package/bin/loanOfferings/dtos/responses/ResolveCustomerSegmentsResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanOfferings/dtos/responses/SegmentFilterResponse.d.ts

@@ -0,0 +1,18 @@
+import { SegmentFilterIdEnum } from '../../enums/SegmentFilterIdEnum';
+/**
+ * Un filtro del catálogo cerrado, tal como lo sirve `GET /segments/filters`. El front lo pinta
+ * desde acá en vez de duplicar la lista.
+ */
+export interface SegmentFilterResponse {
+    filterId: SegmentFilterIdEnum;
+    name: string;
+    description: string;
+    /**
+     * `false` cuando el filtro está declarado pero ningún sistema produce su insumo: la pantalla lo
+     * muestra deshabilitado con la razón y el lambda rechaza guardarlo (422). Ofrecer un filtro que
+     * no evalúa nada es la mentira que este módulo viene a cerrar.
+     */
+    hasSource: boolean;
+    /** Por qué no tiene fuente todavía. `null` cuando `hasSource` es `true`. */
+    missingSourceReason: string | null;
+}

package/bin/loanOfferings/dtos/responses/SegmentFilterResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanOfferings/dtos/responses/SegmentResponse.d.ts

@@ -0,0 +1,27 @@
+import { SegmentColorSlotEnum } from '../../enums/SegmentColorSlotEnum';
+import { SegmentFilterIdEnum } from '../../enums/SegmentFilterIdEnum';
+import { SegmentStatusEnum } from '../../enums/SegmentStatusEnum';
+/**
+ * Shape de salida de un segmento (GET / POST / PUT de /segments).
+ *
+ * Un cliente pertenece si cumple AL MENOS UNO de los `filterIds` (OR) **o** está en `memberIds`.
+ * No hay prioridad ni desempate: el cliente puede estar en varios segmentos a la vez.
+ */
+export interface SegmentResponse {
+    segmentId: string;
+    name: string;
+    description: string | null;
+    colorSlot: SegmentColorSlotEnum;
+    /** Ids del catálogo cerrado. Vacío = no alcanza a nadie por regla. */
+    filterIds: SegmentFilterIdEnum[];
+    /** `retailCustomerId` agregados a mano. Ganan aunque el cliente no cumpla ningún filtro. */
+    memberIds: string[];
+    /** El catch-all implícito. No acepta filtros ni individuos, no se archiva y solo se renombra. */
+    isDefault: boolean;
+    status: SegmentStatusEnum;
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    updatedBy: string;
+}

package/bin/loanOfferings/dtos/responses/SegmentResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanOfferings/dtos/responses/StorePolicyResponse.d.ts

@@ -49,6 +49,12 @@ export interface StorePolicyResponse {
     targetLevels: CreditPlanLevelEnum[] | null;
     /** ALCANCE. `null` = todos los SKUs. */
     targetSkus: string[] | null;
+    /**
+     * ALCANCE. `null` = todos los segmentos. Un cliente puede estar en varios a la vez.
+     * Opcional hasta que todos los productores lo emitan: obligatorio rompe a quien construya la
+     * respuesta y todavía no lo llene.
+     */
+    segmentIds?: string[] | null;
     validFrom: string | null;
     validUntil: string | null;
     reason: string | null;

package/bin/loanOfferings/enums/SegmentColorSlotEnum.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Ranura de color con la que el Portal Admin pinta el chip del segmento. Es un catálogo CERRADO de
+ * ocho: el valor viaja como llave, no como color, y la paleta la resuelve el front.
+ * @enum {string}
+ */
+export declare enum SegmentColorSlotEnum {
+    SLATE = "slate",
+    SKY = "sky",
+    AMBER = "amber",
+    VIOLET = "violet",
+    EMERALD = "emerald",
+    TEAL = "teal",
+    PINK = "pink",
+    ROSE = "rose"
+}

package/bin/loanOfferings/enums/SegmentColorSlotEnum.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SegmentColorSlotEnum = void 0;
+/**
+ * Ranura de color con la que el Portal Admin pinta el chip del segmento. Es un catálogo CERRADO de
+ * ocho: el valor viaja como llave, no como color, y la paleta la resuelve el front.
+ * @enum {string}
+ */
+var SegmentColorSlotEnum;
+(function (SegmentColorSlotEnum) {
+    SegmentColorSlotEnum["SLATE"] = "slate";
+    SegmentColorSlotEnum["SKY"] = "sky";
+    SegmentColorSlotEnum["AMBER"] = "amber";
+    SegmentColorSlotEnum["VIOLET"] = "violet";
+    SegmentColorSlotEnum["EMERALD"] = "emerald";
+    SegmentColorSlotEnum["TEAL"] = "teal";
+    SegmentColorSlotEnum["PINK"] = "pink";
+    SegmentColorSlotEnum["ROSE"] = "rose";
+})(SegmentColorSlotEnum || (exports.SegmentColorSlotEnum = SegmentColorSlotEnum = {}));

package/bin/loanOfferings/enums/SegmentFilterIdEnum.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Catálogo CERRADO de filtros que un segmento puede activar. El operador elige de la lista, no la
+ * edita: un filtro que no está aquí no lo evalúa nadie.
+ *
+ * El nombre y la descripción que ve el operador NO viven acá: los sirve
+ * `GET /segments/filters`, junto con la marca de si el filtro tiene fuente de datos hoy.
+ * @enum {string}
+ */
+export declare enum SegmentFilterIdEnum {
+    IS_EMPLOYEE = "isEmployee",
+    LEVEL_GOLD = "levelGold",
+    LEVEL_SILVER = "levelSilver",
+    LEVEL_BRONZE = "levelBronze",
+    COMPLETED_CREDITS_GTE_3 = "completedCreditsGte3",
+    NO_DELINQUENCY_LAST_6_MONTHS = "noDelinquencyLast6Months",
+    NO_LIFETIME_WRITE_OFFS = "noLifetimeWriteOffs",
+    NO_LIFETIME_RESTRUCTURES = "noLifetimeRestructures"
+}

package/bin/loanOfferings/enums/SegmentFilterIdEnum.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SegmentFilterIdEnum = void 0;
+/**
+ * Catálogo CERRADO de filtros que un segmento puede activar. El operador elige de la lista, no la
+ * edita: un filtro que no está aquí no lo evalúa nadie.
+ *
+ * El nombre y la descripción que ve el operador NO viven acá: los sirve
+ * `GET /segments/filters`, junto con la marca de si el filtro tiene fuente de datos hoy.
+ * @enum {string}
+ */
+var SegmentFilterIdEnum;
+(function (SegmentFilterIdEnum) {
+    SegmentFilterIdEnum["IS_EMPLOYEE"] = "isEmployee";
+    SegmentFilterIdEnum["LEVEL_GOLD"] = "levelGold";
+    SegmentFilterIdEnum["LEVEL_SILVER"] = "levelSilver";
+    SegmentFilterIdEnum["LEVEL_BRONZE"] = "levelBronze";
+    SegmentFilterIdEnum["COMPLETED_CREDITS_GTE_3"] = "completedCreditsGte3";
+    SegmentFilterIdEnum["NO_DELINQUENCY_LAST_6_MONTHS"] = "noDelinquencyLast6Months";
+    SegmentFilterIdEnum["NO_LIFETIME_WRITE_OFFS"] = "noLifetimeWriteOffs";
+    SegmentFilterIdEnum["NO_LIFETIME_RESTRUCTURES"] = "noLifetimeRestructures";
+})(SegmentFilterIdEnum || (exports.SegmentFilterIdEnum = SegmentFilterIdEnum = {}));

package/bin/loanOfferings/enums/SegmentStatusEnum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Estado PERSISTIDO de un segmento de clientes. No hay borrado: `ARCHIVED` lo saca del motor y de
+ * los selectores, y las referencias que le apuntan siguen resolviendo su nombre.
+ * @enum {string}
+ */
+export declare enum SegmentStatusEnum {
+    ACTIVE = "ACTIVE",
+    ARCHIVED = "ARCHIVED"
+}

package/bin/loanOfferings/enums/SegmentStatusEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SegmentStatusEnum = void 0;
+/**
+ * Estado PERSISTIDO de un segmento de clientes. No hay borrado: `ARCHIVED` lo saca del motor y de
+ * los selectores, y las referencias que le apuntan siguen resolviendo su nombre.
+ * @enum {string}
+ */
+var SegmentStatusEnum;
+(function (SegmentStatusEnum) {
+    SegmentStatusEnum["ACTIVE"] = "ACTIVE";
+    SegmentStatusEnum["ARCHIVED"] = "ARCHIVED";
+})(SegmentStatusEnum || (exports.SegmentStatusEnum = SegmentStatusEnum = {}));

package/bin/loanOfferings/index.d.ts

@@ -10,6 +10,9 @@ export * from './enums/PromotionPhaseEnum';
 export * from './enums/PromotionLogEventEnum';
 export * from './enums/StorePolicyStatusEnum';
 export * from './enums/StorePolicyPhaseEnum';
+export * from './enums/SegmentStatusEnum';
+export * from './enums/SegmentColorSlotEnum';
+export * from './enums/SegmentFilterIdEnum';
 export * from './dtos/CreditPlan';
 export * from './dtos/Financier';
 export * from './dtos/RetailerCreditPlan';
@@ -30,6 +33,10 @@ export * from './dtos/requests/ConsumePromotionRequest';
 export * from './dtos/requests/CreateStorePolicyRequest';
 export * from './dtos/requests/UpdateStorePolicyRequest';
 export * from './dtos/requests/ChangeStorePolicyStatusRequest';
+export * from './dtos/requests/CreateSegmentRequest';
+export * from './dtos/requests/UpdateSegmentRequest';
+export * from './dtos/requests/ChangeSegmentStatusRequest';
+export * from './dtos/requests/ResolveCustomerSegmentsRequest';
 export * from './dtos/responses/CreditPlanResponse';
 export * from './dtos/responses/FinancierResponse';
 export * from './dtos/responses/RetailerCreditPlanResponse';
@@ -37,4 +44,8 @@ export * from './dtos/responses/SimulationResultResponse';
 export * from './dtos/responses/PromotionResponse';
 export * from './dtos/responses/PromotionLogEntryResponse';
 export * from './dtos/responses/ConsumePromotionResponse';
+export * from './dtos/responses/PromotedSkusResponse';
 export * from './dtos/responses/StorePolicyResponse';
+export * from './dtos/responses/SegmentResponse';
+export * from './dtos/responses/SegmentFilterResponse';
+export * from './dtos/responses/ResolveCustomerSegmentsResponse';

package/bin/loanOfferings/index.js

@@ -27,6 +27,9 @@ __exportStar(require("./enums/PromotionPhaseEnum"), exports);
 __exportStar(require("./enums/PromotionLogEventEnum"), exports);
 __exportStar(require("./enums/StorePolicyStatusEnum"), exports);
 __exportStar(require("./enums/StorePolicyPhaseEnum"), exports);
+__exportStar(require("./enums/SegmentStatusEnum"), exports);
+__exportStar(require("./enums/SegmentColorSlotEnum"), exports);
+__exportStar(require("./enums/SegmentFilterIdEnum"), exports);
 // Entity DTOs
 __exportStar(require("./dtos/CreditPlan"), exports);
 __exportStar(require("./dtos/Financier"), exports);
@@ -49,6 +52,10 @@ __exportStar(require("./dtos/requests/ConsumePromotionRequest"), exports);
 __exportStar(require("./dtos/requests/CreateStorePolicyRequest"), exports);
 __exportStar(require("./dtos/requests/UpdateStorePolicyRequest"), exports);
 __exportStar(require("./dtos/requests/ChangeStorePolicyStatusRequest"), exports);
+__exportStar(require("./dtos/requests/CreateSegmentRequest"), exports);
+__exportStar(require("./dtos/requests/UpdateSegmentRequest"), exports);
+__exportStar(require("./dtos/requests/ChangeSegmentStatusRequest"), exports);
+__exportStar(require("./dtos/requests/ResolveCustomerSegmentsRequest"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/CreditPlanResponse"), exports);
 __exportStar(require("./dtos/responses/FinancierResponse"), exports);
@@ -57,4 +64,8 @@ __exportStar(require("./dtos/responses/SimulationResultResponse"), exports);
 __exportStar(require("./dtos/responses/PromotionResponse"), exports);
 __exportStar(require("./dtos/responses/PromotionLogEntryResponse"), exports);
 __exportStar(require("./dtos/responses/ConsumePromotionResponse"), exports);
+__exportStar(require("./dtos/responses/PromotedSkusResponse"), exports);
 __exportStar(require("./dtos/responses/StorePolicyResponse"), exports);
+__exportStar(require("./dtos/responses/SegmentResponse"), exports);
+__exportStar(require("./dtos/responses/SegmentFilterResponse"), exports);
+__exportStar(require("./dtos/responses/ResolveCustomerSegmentsResponse"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.379.0",
+  "version": "3.381.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/loanOfferings/dtos/requests/ChangeSegmentStatusRequest.ts

@@ -0,0 +1,20 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional, IsString, MaxLength } from 'class-validator';
+import { SegmentStatusEnum } from '../../enums/SegmentStatusEnum';
+
+/**
+ * Body de PUT /segments/:segmentId/status — archiva o reactiva un segmento.
+ * No hay borrado: archivar lo saca del motor y de los selectores sin dejar huérfanas a las
+ * políticas y promociones que le apuntan. `reason` queda en la bitácora.
+ */
+export class ChangeSegmentStatusRequest {
+    @Expose()
+    @IsEnum(SegmentStatusEnum)
+    status!: SegmentStatusEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(280)
+    reason?: string;
+}

package/src/loanOfferings/dtos/requests/CreateSegmentRequest.ts

@@ -0,0 +1,49 @@
+import { Expose } from 'class-transformer';
+import { IsArray, IsEnum, IsOptional, IsString, MaxLength } from 'class-validator';
+import { SegmentColorSlotEnum } from '../../enums/SegmentColorSlotEnum';
+
+/**
+ * Body de POST /segments — alta de un segmento de clientes.
+ * Nace en `ACTIVE`: `segmentId`, `status`, `version`, `isDefault` y la auditoría los asigna el
+ * lambda y NO viajan en el request. Que cada filtro exista en el catálogo y tenga fuente lo valida
+ * el lambda contra `GET /segments/filters`.
+ */
+export class CreateSegmentRequest {
+    @Expose()
+    @IsString()
+    @MaxLength(120)
+    name!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(500)
+    description?: string;
+
+    /** Ranura de color del chip. Ausente = `slate`. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(SegmentColorSlotEnum)
+    colorSlot?: SegmentColorSlotEnum;
+
+    /**
+     * Filtros del catálogo cerrado. Un cliente pertenece si cumple AL MENOS UNO — es un OR, no un
+     * AND. Se valida contra el catálogo en el lambda (422), no acá, para poder nombrar el filtro
+     * desconocido y el que todavía no tiene fuente.
+     */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    filterIds?: string[];
+
+    /**
+     * Clientes agregados a mano por `retailCustomerId`. Ganan siempre, cumplan o no un filtro.
+     * Un segmento puede nacer SOLO con esta lista, sin ningún filtro activo.
+     */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    memberIds?: string[];
+}

package/src/loanOfferings/dtos/requests/CreateStorePolicyRequest.ts

@@ -130,6 +130,14 @@ export class CreateStorePolicyRequest {
     @IsEnum(CreditPlanLevelEnum, { each: true })
     targetLevels?: CreditPlanLevelEnum[];
 
+    /** Alcance: segmentos alcanzados. Ausente = todos los segmentos. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsString({ each: true })
+    segmentIds?: string[];
+
     /** Alcance: SKUs alcanzados. Ausente = todos los productos. */
     @Expose()
     @IsOptional()

package/src/loanOfferings/dtos/requests/ResolveCustomerSegmentsRequest.ts

@@ -0,0 +1,57 @@
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsEnum, IsInt, IsOptional, IsString, Min } from 'class-validator';
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+
+/**
+ * Body de POST /private/segments/resolve — los hechos del cliente contra los que se evalúan los
+ * filtros. Los junta quien ya tiene al cliente delante (el wizard o el motor de crédito); este
+ * lambda no sale a buscarlos a otro silo en el camino caliente.
+ *
+ * Un hecho AUSENTE hace que su filtro NO se cumpla: sin el dato no se puede afirmar que el cliente
+ * califica, y de las dos salidas la segura es dejarlo fuera.
+ */
+export class ResolveCustomerSegmentsRequest {
+    @Expose()
+    @IsString()
+    retailCustomerId!: string;
+
+    /** Colaborador de la red. Hoy ningún sistema lo produce — ver la lista de individuos. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    isEmployee?: boolean;
+
+    /** Nivel que resolvió loan-scoring a partir del SCI. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(CreditPlanLevelEnum)
+    sciLevel?: CreditPlanLevelEnum;
+
+    /** Créditos cerrados en toda la vida del cliente. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    completedCredits?: number;
+
+    /** Días de mora acumulados en la ventana de 180 días. `0` es sin mora. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    delinquencyDaysLast6M?: number;
+
+    /** Bajas contables vitalicias. `0` es ninguna. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    lifetimeWriteOffs?: number;
+
+    /** Reestructuras vitalicias. `0` es ninguna. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    lifetimeRestructures?: number;
+}

package/src/loanOfferings/dtos/requests/SimulateCreditPlanRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsInt, IsNumber, IsOptional, IsString, Max, Min } from 'class-validator';
+import { IsArray, IsInt, IsNumber, IsOptional, IsString, Max, Min } from 'class-validator';
 
 /**
  * Body de POST /private/credit-plans/:planId/simulate y query de GET /credit-plans/:planId/simulator.
@@ -45,4 +45,14 @@ export class SimulateCreditPlanRequest {
     @IsOptional()
     @IsString()
     productSku?: string;
+
+    /**
+     * Segmentos del cliente, los que devolvió `POST /private/segments/resolve`. Un arreglo vacío
+     * declara que el cliente no está en ninguno; ausente declara que el caller no lo consultó.
+     */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    customerSegmentIds?: string[];
 }

package/src/loanOfferings/dtos/requests/UpdateSegmentRequest.ts

@@ -0,0 +1,49 @@
+import { Expose } from 'class-transformer';
+import { IsArray, IsEnum, IsOptional, IsString, MaxLength } from 'class-validator';
+import { SegmentColorSlotEnum } from '../../enums/SegmentColorSlotEnum';
+
+/**
+ * Body de PUT /segments/:segmentId — edición parcial (todos los campos opcionales). Sube `version`.
+ * El cambio de estado va por su endpoint dedicado.
+ *
+ * Un arreglo vacío VACÍA la lista; ausente la deja como está. El segmento por omisión
+ * (`isDefault`) solo acepta el cambio de nombre.
+ */
+export class UpdateSegmentRequest {
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(120)
+    name?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(500)
+    description?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(SegmentColorSlotEnum)
+    colorSlot?: SegmentColorSlotEnum;
+
+    /** Reemplaza la lista entera; `[]` deja el segmento sin filtros. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    filterIds?: string[];
+
+    /** Reemplaza la lista entera; `[]` saca a todos los agregados a mano. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    memberIds?: string[];
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(280)
+    reason?: string;
+}

package/src/loanOfferings/dtos/requests/UpdateStorePolicyRequest.ts

@@ -69,6 +69,14 @@ export class UpdateStorePolicyRequest {
     @IsEnum(CreditPlanLevelEnum, { each: true })
     targetLevels?: CreditPlanLevelEnum[];
 
+    /** Alcance: segmentos alcanzados. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsString({ each: true })
+    segmentIds?: string[];
+
     @Expose()
     @IsOptional()
     @IsArray()

package/src/loanOfferings/dtos/responses/PromotedSkusResponse.ts

@@ -0,0 +1,14 @@
+/**
+ * SKUs que hoy traen promoción en una tienda, para el badge del catálogo del wizard.
+ *
+ * El catálogo se pinta en el paso 03 y el nivel del cliente recién sale en el paso 05, así que la
+ * lista solo incluye promociones que alcanzan a CUALQUIER nivel: una acotada por nivel prometería
+ * un beneficio que la cotización puede no dar, y el vendedor ya se lo dijo al cliente.
+ *
+ * Solo entran las promociones que ACOTAN por SKU. Una promoción de «todos los productos» no es una
+ * propiedad del equipo y marcaría el catálogo entero, que es lo mismo que no marcar nada.
+ */
+export interface PromotedSkusResponse {
+    /** SKUs con al menos una promoción vigente que los nombra. Vacío si no hay ninguna. */
+    skus: string[];
+}

package/src/loanOfferings/dtos/responses/ResolveCustomerSegmentsResponse.ts

@@ -0,0 +1,10 @@
+/**
+ * Respuesta de POST /private/segments/resolve: los segmentos a los que pertenece el cliente HOY.
+ *
+ * Puede venir VACÍO, y eso no es un error: «estar en Estándar» es justamente no pertenecer a
+ * ningún segmento preferente. El segmento por omisión NUNCA se devuelve acá.
+ */
+export interface ResolveCustomerSegmentsResponse {
+    retailCustomerId: string;
+    segmentIds: string[];
+}

package/src/loanOfferings/dtos/responses/SegmentFilterResponse.ts

@@ -0,0 +1,19 @@
+import { SegmentFilterIdEnum } from '../../enums/SegmentFilterIdEnum';
+
+/**
+ * Un filtro del catálogo cerrado, tal como lo sirve `GET /segments/filters`. El front lo pinta
+ * desde acá en vez de duplicar la lista.
+ */
+export interface SegmentFilterResponse {
+    filterId: SegmentFilterIdEnum;
+    name: string;
+    description: string;
+    /**
+     * `false` cuando el filtro está declarado pero ningún sistema produce su insumo: la pantalla lo
+     * muestra deshabilitado con la razón y el lambda rechaza guardarlo (422). Ofrecer un filtro que
+     * no evalúa nada es la mentira que este módulo viene a cerrar.
+     */
+    hasSource: boolean;
+    /** Por qué no tiene fuente todavía. `null` cuando `hasSource` es `true`. */
+    missingSourceReason: string | null;
+}

package/src/loanOfferings/dtos/responses/SegmentResponse.ts

@@ -0,0 +1,28 @@
+import { SegmentColorSlotEnum } from '../../enums/SegmentColorSlotEnum';
+import { SegmentFilterIdEnum } from '../../enums/SegmentFilterIdEnum';
+import { SegmentStatusEnum } from '../../enums/SegmentStatusEnum';
+
+/**
+ * Shape de salida de un segmento (GET / POST / PUT de /segments).
+ *
+ * Un cliente pertenece si cumple AL MENOS UNO de los `filterIds` (OR) **o** está en `memberIds`.
+ * No hay prioridad ni desempate: el cliente puede estar en varios segmentos a la vez.
+ */
+export interface SegmentResponse {
+    segmentId: string;
+    name: string;
+    description: string | null;
+    colorSlot: SegmentColorSlotEnum;
+    /** Ids del catálogo cerrado. Vacío = no alcanza a nadie por regla. */
+    filterIds: SegmentFilterIdEnum[];
+    /** `retailCustomerId` agregados a mano. Ganan aunque el cliente no cumpla ningún filtro. */
+    memberIds: string[];
+    /** El catch-all implícito. No acepta filtros ni individuos, no se archiva y solo se renombra. */
+    isDefault: boolean;
+    status: SegmentStatusEnum;
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    updatedBy: string;
+}

package/src/loanOfferings/dtos/responses/StorePolicyResponse.ts

@@ -54,6 +54,12 @@ export interface StorePolicyResponse {
     targetLevels: CreditPlanLevelEnum[] | null;
     /** ALCANCE. `null` = todos los SKUs. */
     targetSkus: string[] | null;
+    /**
+     * ALCANCE. `null` = todos los segmentos. Un cliente puede estar en varios a la vez.
+     * Opcional hasta que todos los productores lo emitan: obligatorio rompe a quien construya la
+     * respuesta y todavía no lo llene.
+     */
+    segmentIds?: string[] | null;
     validFrom: string | null;
     validUntil: string | null;
     reason: string | null;

package/src/loanOfferings/enums/SegmentColorSlotEnum.ts

@@ -0,0 +1,15 @@
+/**
+ * Ranura de color con la que el Portal Admin pinta el chip del segmento. Es un catálogo CERRADO de
+ * ocho: el valor viaja como llave, no como color, y la paleta la resuelve el front.
+ * @enum {string}
+ */
+export enum SegmentColorSlotEnum {
+    SLATE = 'slate',
+    SKY = 'sky',
+    AMBER = 'amber',
+    VIOLET = 'violet',
+    EMERALD = 'emerald',
+    TEAL = 'teal',
+    PINK = 'pink',
+    ROSE = 'rose',
+}

package/src/loanOfferings/enums/SegmentFilterIdEnum.ts

@@ -0,0 +1,18 @@
+/**
+ * Catálogo CERRADO de filtros que un segmento puede activar. El operador elige de la lista, no la
+ * edita: un filtro que no está aquí no lo evalúa nadie.
+ *
+ * El nombre y la descripción que ve el operador NO viven acá: los sirve
+ * `GET /segments/filters`, junto con la marca de si el filtro tiene fuente de datos hoy.
+ * @enum {string}
+ */
+export enum SegmentFilterIdEnum {
+    IS_EMPLOYEE = 'isEmployee',
+    LEVEL_GOLD = 'levelGold',
+    LEVEL_SILVER = 'levelSilver',
+    LEVEL_BRONZE = 'levelBronze',
+    COMPLETED_CREDITS_GTE_3 = 'completedCreditsGte3',
+    NO_DELINQUENCY_LAST_6_MONTHS = 'noDelinquencyLast6Months',
+    NO_LIFETIME_WRITE_OFFS = 'noLifetimeWriteOffs',
+    NO_LIFETIME_RESTRUCTURES = 'noLifetimeRestructures',
+}

package/src/loanOfferings/enums/SegmentStatusEnum.ts

@@ -0,0 +1,9 @@
+/**
+ * Estado PERSISTIDO de un segmento de clientes. No hay borrado: `ARCHIVED` lo saca del motor y de
+ * los selectores, y las referencias que le apuntan siguen resolviendo su nombre.
+ * @enum {string}
+ */
+export enum SegmentStatusEnum {
+    ACTIVE = 'ACTIVE',
+    ARCHIVED = 'ARCHIVED',
+}

package/src/loanOfferings/index.ts

@@ -11,6 +11,9 @@ export * from './enums/PromotionPhaseEnum';
 export * from './enums/PromotionLogEventEnum';
 export * from './enums/StorePolicyStatusEnum';
 export * from './enums/StorePolicyPhaseEnum';
+export * from './enums/SegmentStatusEnum';
+export * from './enums/SegmentColorSlotEnum';
+export * from './enums/SegmentFilterIdEnum';
 
 // Entity DTOs
 export * from './dtos/CreditPlan';
@@ -35,6 +38,10 @@ export * from './dtos/requests/ConsumePromotionRequest';
 export * from './dtos/requests/CreateStorePolicyRequest';
 export * from './dtos/requests/UpdateStorePolicyRequest';
 export * from './dtos/requests/ChangeStorePolicyStatusRequest';
+export * from './dtos/requests/CreateSegmentRequest';
+export * from './dtos/requests/UpdateSegmentRequest';
+export * from './dtos/requests/ChangeSegmentStatusRequest';
+export * from './dtos/requests/ResolveCustomerSegmentsRequest';
 
 // Response DTOs
 export * from './dtos/responses/CreditPlanResponse';
@@ -44,4 +51,8 @@ export * from './dtos/responses/SimulationResultResponse';
 export * from './dtos/responses/PromotionResponse';
 export * from './dtos/responses/PromotionLogEntryResponse';
 export * from './dtos/responses/ConsumePromotionResponse';
+export * from './dtos/responses/PromotedSkusResponse';
 export * from './dtos/responses/StorePolicyResponse';
+export * from './dtos/responses/SegmentResponse';
+export * from './dtos/responses/SegmentFilterResponse';
+export * from './dtos/responses/ResolveCustomerSegmentsResponse';