@fiado/type-kit 3.511.0 → 3.513.0

package/_test_/unit/loanCredit/updateLoanBorrowerSciRequest.test.ts

@@ -0,0 +1,46 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { UpdateLoanBorrowerSciRequest } from '../../../src/loanCredit/index';
+import { ClientLevelEnum } from '../../../src/loanScoring/enums/ClientLevelEnum';
+
+const errorsOf = async (body: Record<string, unknown>): Promise<string[]> => {
+    const errors = await validate(plainToInstance(UpdateLoanBorrowerSciRequest, body));
+    return errors.map((error) => error.property);
+};
+
+const VALID = { evaluationId: '01M4C1RZ0000000000000000AA', sciScore: 64, clientLevel: ClientLevelEnum.SILVER };
+
+describe('UpdateLoanBorrowerSciRequest', () => {
+    it('acepta el resultado de una evaluación', async () => {
+        expect(await errorsOf(VALID)).toEqual([]);
+    });
+
+    it('acepta NOT_ELIGIBLE: también es el nivel de la última evaluación', async () => {
+        expect(await errorsOf({ ...VALID, sciScore: 12, clientLevel: ClientLevelEnum.NOT_ELIGIBLE })).toEqual([]);
+    });
+
+    it('exige los tres campos', async () => {
+        expect((await errorsOf({})).sort()).toEqual(['clientLevel', 'evaluationId', 'sciScore']);
+    });
+
+    it('rechaza un score fuera de 0-100 o con decimales', async () => {
+        expect(await errorsOf({ ...VALID, sciScore: 101 })).toEqual(['sciScore']);
+        expect(await errorsOf({ ...VALID, sciScore: -1 })).toEqual(['sciScore']);
+        expect(await errorsOf({ ...VALID, sciScore: 64.5 })).toEqual(['sciScore']);
+    });
+
+    it('rechaza un nivel que no está en el catálogo', async () => {
+        expect(await errorsOf({ ...VALID, clientLevel: 'PLATINUM' })).toEqual(['clientLevel']);
+    });
+
+    it('rechaza un evaluationId vacío', async () => {
+        expect(await errorsOf({ ...VALID, evaluationId: '' })).toEqual(['evaluationId']);
+    });
+
+    it('exige un ULID en mayúsculas: el acreditado ordena las evaluaciones comparando ids', async () => {
+        expect(await errorsOf({ ...VALID, evaluationId: '01m4c1rz0000000000000000aa' })).toEqual(['evaluationId']);
+        expect(await errorsOf({ ...VALID, evaluationId: '3f2b8c1e-9d4a-4c1b-8e2f-1a2b3c4d5e6f' })).toEqual(['evaluationId']);
+        expect(await errorsOf({ ...VALID, evaluationId: '01M4C1RZ0000000000000000A' })).toEqual(['evaluationId']);
+    });
+});

package/_test_/unit/retailPromotions/activeSalePromotionsBySkus.test.ts

@@ -0,0 +1,58 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    ACTIVE_SALE_PROMOTIONS_MAX_SKUS,
+    ActiveSalePromotionsBySkusRequest,
+    SkuSalePromotionLookupStatusEnum,
+} from '../../../src/retailPromotions/index';
+import type { ActiveSalePromotionsBySkusResponse } from '../../../src/retailPromotions/index';
+import { CatalogSourceStatusEnum } from '../../../src/retailCatalog/index';
+import type { GetInventorySkuResponse, InventoryLensListItem, InventoryLensResponse } from '../../../src/retailCatalog/index';
+
+const errorsOf = async (body: object) =>
+    (await validate(plainToInstance(ActiveSalePromotionsBySkusRequest, body, { excludeExtraneousValues: true }))).map((e) => e.property);
+
+const valid = { tenantId: 'SUREKEEP', retailerId: 'ret-1', items: [{ sku: 'SKU-1', category: 'PHONE', tier: 'MID' }] };
+
+describe('ActiveSalePromotionsBySkusRequest', () => {
+    it('acepta tenant, cadena, tienda opcional y SKUs con tipo y gama opcionales', async () => {
+        expect(await errorsOf(valid)).toEqual([]);
+        expect(await errorsOf({ ...valid, storeId: 'st-1', items: [{ sku: 'SKU-2' }] })).toEqual([]);
+    });
+
+    it('un SKU vacío no tumba el lote: se resuelve como INVALID_ID por entrada', async () => {
+        expect(await errorsOf({ ...valid, items: [{ sku: '' }] })).toEqual([]);
+    });
+
+    it.each([
+        ['sin tenantId', { ...valid, tenantId: undefined }, 'tenantId'],
+        ['sin retailerId', { ...valid, retailerId: '' }, 'retailerId'],
+        ['sin items', { ...valid, items: undefined }, 'items'],
+        ['tipo fuera del enum', { ...valid, items: [{ sku: 'A', category: 'CAR' }] }, 'items'],
+    ])('rechaza %s', async (_l, body, property) => {
+        expect(await errorsOf(body)).toContain(property);
+    });
+
+    it(`rechaza más de ${ACTIVE_SALE_PROMOTIONS_MAX_SKUS} SKUs`, async () => {
+        const items = Array.from({ length: ACTIVE_SALE_PROMOTIONS_MAX_SKUS + 1 }, (_v, i) => ({ sku: `S${i}` }));
+        expect(await errorsOf({ ...valid, items })).toContain('items');
+    });
+});
+
+describe('contratos de promos vigentes por SKU', () => {
+    it('una entrada por SKU con su estado y sus promos', () => {
+        const response: ActiveSalePromotionsBySkusResponse = {
+            items: [{ sku: 'SKU-1', status: SkuSalePromotionLookupStatusEnum.OK, promotions: [] }],
+        };
+        expect(Object.values(SkuSalePromotionLookupStatusEnum)).toEqual(['OK', 'UNAVAILABLE', 'INVALID_ID']);
+        expect(response.items[0]?.status).toBe('OK');
+    });
+
+    it('la ficha y el lente del catálogo llevan las promos y el estado de su fuente', () => {
+        const sku: Pick<GetInventorySkuResponse, 'promotions' | 'sources'> = { promotions: null, sources: { promotions: CatalogSourceStatusEnum.UNAVAILABLE } };
+        const row: Pick<InventoryLensListItem, 'hasPromotion' | 'promotionNames'> = { hasPromotion: true, promotionNames: ['Hot Sale'] };
+        const lens: Pick<InventoryLensResponse, 'sources'> = { sources: { promotions: CatalogSourceStatusEnum.OK } };
+        expect([sku.sources?.promotions, row.promotionNames, lens.sources?.promotions]).toEqual(['UNAVAILABLE', ['Hot Sale'], 'OK']);
+    });
+});

package/bin/datalakeReports/dtos/ReportDefinitionDto.d.ts

@@ -0,0 +1,35 @@
+export type ReportAudience = 'backoffice' | 'private' | 'public';
+export type ReportParamType = 'date' | 'string' | 'int' | 'enum' | 'list' | 'boolean';
+export declare class ReportParamSpecDto {
+    type: ReportParamType;
+    required?: boolean;
+    default?: string | number | boolean | string[];
+    values?: string[];
+    max?: number;
+    min?: number;
+}
+export declare class ReportColumnDto {
+    name: string;
+    type: 'string' | 'number' | 'date' | 'datetime' | 'boolean';
+    label: string;
+}
+export declare class ReportDefinitionDto {
+    /** dominio.nombre */
+    id: string;
+    version: number;
+    title: string;
+    description: string;
+    source: {
+        layer: 'gold' | 'silver';
+        databases: string[];
+    };
+    pii: boolean;
+    audiences: ReportAudience[];
+    permission: string;
+    mode: 'sync' | 'async';
+    cacheSeconds: number;
+    maxBytesScanned?: number;
+    params: Record<string, ReportParamSpecDto>;
+    principalParams: string[];
+    columns: ReportColumnDto[];
+}

package/bin/datalakeReports/dtos/ReportDefinitionDto.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportDefinitionDto = exports.ReportColumnDto = exports.ReportParamSpecDto = void 0;
+class ReportParamSpecDto {
+}
+exports.ReportParamSpecDto = ReportParamSpecDto;
+class ReportColumnDto {
+}
+exports.ReportColumnDto = ReportColumnDto;
+class ReportDefinitionDto {
+}
+exports.ReportDefinitionDto = ReportDefinitionDto;

package/bin/datalakeReports/dtos/ReportResultDto.d.ts

@@ -0,0 +1,18 @@
+import { ReportStatusEnum } from "../enums/ReportStatusEnum";
+import { ReportColumnDto } from "./ReportDefinitionDto";
+export type ReportRow = Record<string, string | number | boolean | null>;
+/** Respuesta de run y de jobs. Con status RUNNING solo vienen reportId y jobId; con FAILED, jobId y reason. */
+export declare class ReportResultDto {
+    status: ReportStatusEnum;
+    reportId?: string;
+    version?: number;
+    jobId: string;
+    columns?: ReportColumnDto[];
+    rows?: ReportRow[];
+    rowCount?: number;
+    nextToken?: string;
+    computedAt?: string;
+    fromCache?: boolean;
+    bytesScanned?: number;
+    reason?: string;
+}

package/bin/datalakeReports/dtos/ReportResultDto.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportResultDto = void 0;
+/** Respuesta de run y de jobs. Con status RUNNING solo vienen reportId y jobId; con FAILED, jobId y reason. */
+class ReportResultDto {
+}
+exports.ReportResultDto = ReportResultDto;

package/bin/datalakeReports/dtos/RunReportRequest.d.ts

@@ -0,0 +1,4 @@
+export declare class RunReportRequest {
+    /** Parámetros del reporte según su definición; los principalParams se ignoran (salen del token). */
+    params?: Record<string, unknown>;
+}

package/bin/datalakeReports/dtos/RunReportRequest.js

@@ -0,0 +1,21 @@
+"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.RunReportRequest = void 0;
+const class_validator_1 = require("class-validator");
+class RunReportRequest {
+}
+exports.RunReportRequest = RunReportRequest;
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Object)
+], RunReportRequest.prototype, "params", void 0);

package/bin/datalakeReports/enums/ReportStatusEnum.d.ts

@@ -0,0 +1,5 @@
+export declare enum ReportStatusEnum {
+    RUNNING = "RUNNING",
+    DONE = "DONE",
+    FAILED = "FAILED"
+}

package/bin/datalakeReports/enums/ReportStatusEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportStatusEnum = void 0;
+var ReportStatusEnum;
+(function (ReportStatusEnum) {
+    ReportStatusEnum["RUNNING"] = "RUNNING";
+    ReportStatusEnum["DONE"] = "DONE";
+    ReportStatusEnum["FAILED"] = "FAILED";
+})(ReportStatusEnum || (exports.ReportStatusEnum = ReportStatusEnum = {}));

package/bin/datalakeReports/index.d.ts

@@ -0,0 +1,4 @@
+export * from './enums/ReportStatusEnum';
+export * from './dtos/ReportDefinitionDto';
+export * from './dtos/RunReportRequest';
+export * from './dtos/ReportResultDto';

package/bin/datalakeReports/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+//enums
+__exportStar(require("./enums/ReportStatusEnum"), exports);
+//dtos
+__exportStar(require("./dtos/ReportDefinitionDto"), exports);
+__exportStar(require("./dtos/RunReportRequest"), exports);
+__exportStar(require("./dtos/ReportResultDto"), exports);

package/bin/index.d.ts

@@ -123,3 +123,4 @@ export * as FileStorage from './fileStorage';
 export * as DynamicForm from './dynamicForm';
 export * as Rewards from './rewards';
 export * as RewardsEligibility from './rewardsEligibility';
+export * as DatalakeReports from './datalakeReports';

package/bin/index.js

@@ -38,7 +38,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IssuanceBusiness = exports.Blacklist = exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.UserTags = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.AppContent = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Biometrics = exports.MetamapConnector = exports.Account = exports.Crypto = void 0;
 exports.RetailPromotions = exports.RetailWizard = exports.RetailCustomer = exports.RetailCards = exports.RetailCatalog = exports.RetailCommission = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.WhatsappConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = void 0;
-exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = void 0;
+exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -244,3 +244,4 @@ exports.Rewards = __importStar(require("./rewards"));
 // RewardsEligibility: contrato del validador de elegibilidad (rewards-eligibility-business) hacia los
 // servicios emisores: POST /events (request/response) y GET /runs/{id}.
 exports.RewardsEligibility = __importStar(require("./rewardsEligibility"));
+exports.DatalakeReports = __importStar(require("./datalakeReports"));

package/bin/loanCredit/dtos/requests/UpdateLoanBorrowerSciRequest.d.ts

@@ -0,0 +1,13 @@
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
+/**
+ * Body de `PUT /private/borrowers/:borrowerId/sci` (loan-credit-business): el resultado de una
+ * evaluación SCI que loan-scoring deja en el acreditado al terminarla.
+ *
+ * El acreditado guarda la evaluación más reciente: una que llegue después de otra más nueva no
+ * cambia nada. `evaluationId` es el ULID de la evaluación, así que su orden es el cronológico.
+ */
+export declare class UpdateLoanBorrowerSciRequest {
+    evaluationId: string;
+    sciScore: number;
+    clientLevel: ClientLevelEnum;
+}

package/bin/loanCredit/dtos/requests/UpdateLoanBorrowerSciRequest.js

@@ -0,0 +1,46 @@
+"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.UpdateLoanBorrowerSciRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ClientLevelEnum_1 = require("../../../loanScoring/enums/ClientLevelEnum");
+/** ULID canónico (Crockford base32 en mayúsculas): solo así la comparación de texto sigue al tiempo. */
+const EVALUATION_ID_PATTERN = /^[0-7][0-9A-HJKMNP-TV-Z]{25}$/;
+/**
+ * Body de `PUT /private/borrowers/:borrowerId/sci` (loan-credit-business): el resultado de una
+ * evaluación SCI que loan-scoring deja en el acreditado al terminarla.
+ *
+ * El acreditado guarda la evaluación más reciente: una que llegue después de otra más nueva no
+ * cambia nada. `evaluationId` es el ULID de la evaluación, así que su orden es el cronológico.
+ */
+class UpdateLoanBorrowerSciRequest {
+}
+exports.UpdateLoanBorrowerSciRequest = UpdateLoanBorrowerSciRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.Matches)(EVALUATION_ID_PATTERN, { message: 'evaluationId debe ser un ULID de 26 caracteres' }),
+    __metadata("design:type", String)
+], UpdateLoanBorrowerSciRequest.prototype, "evaluationId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], UpdateLoanBorrowerSciRequest.prototype, "sciScore", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(ClientLevelEnum_1.ClientLevelEnum),
+    __metadata("design:type", String)
+], UpdateLoanBorrowerSciRequest.prototype, "clientLevel", void 0);

package/bin/loanCredit/index.d.ts

@@ -14,6 +14,7 @@ export * from './dtos/AppliedStorePolicySnapshot';
 export * from './dtos/CandidatePlanSnapshot';
 export * from './dtos/EffectiveTermsSnapshot';
 export * from './dtos/requests/UpsertLoanBorrowerRequest';
+export * from './dtos/requests/UpdateLoanBorrowerSciRequest';
 export * from './dtos/requests/OriginateLoanCreditRequest';
 export * from './dtos/requests/QuoteLoanCreditRequest';
 export * from './dtos/requests/SignLoanCreditRequest';

package/bin/loanCredit/index.js

@@ -36,6 +36,7 @@ __exportStar(require("./dtos/CandidatePlanSnapshot"), exports);
 __exportStar(require("./dtos/EffectiveTermsSnapshot"), exports);
 // Request DTOs
 __exportStar(require("./dtos/requests/UpsertLoanBorrowerRequest"), exports);
+__exportStar(require("./dtos/requests/UpdateLoanBorrowerSciRequest"), exports);
 __exportStar(require("./dtos/requests/OriginateLoanCreditRequest"), exports);
 __exportStar(require("./dtos/requests/QuoteLoanCreditRequest"), exports);
 __exportStar(require("./dtos/requests/SignLoanCreditRequest"), exports);

package/bin/retailCatalog/dtos/responses/GetInventorySkuResponse.d.ts

@@ -2,6 +2,8 @@ import type { InventoryItemStatusEnum } from '../../enums/InventoryItemStatusEnu
 import type { InventoryMovementTypeEnum } from '../../enums/InventoryMovementTypeEnum';
 import type { InventoryMovementReasonEnum } from '../../enums/InventoryMovementReasonEnum';
 import type { SkuPriceEntry } from './SkuPriceEntry';
+import type { CatalogSourceStatusEnum } from '../../enums/CatalogSourceStatusEnum';
+import type { ActiveSalePromotionSummary } from '../../../retailPromotions/dtos/responses/ActiveSalePromotionsBySkusResponse';
 /** Un movimiento del libro de inventario. */
 export interface InventoryMovementEntry {
     storeId: string;
@@ -36,4 +38,11 @@ export interface GetInventorySkuResponse {
     /** Vacío si el SKU se rastrea por cantidad. */
     piecesByStore: InventoryStorePieces[];
     currentPrice: SkuPriceEntry | null;
+    /** Promos de venta vigentes del SKU; `null` si retail-promotions no respondió. */
+    promotions?: ActiveSalePromotionSummary[] | null;
+    sources?: InventorySkuSources;
+}
+/** Estado de las fuentes externas de la ficha. */
+export interface InventorySkuSources {
+    promotions: CatalogSourceStatusEnum;
 }

package/bin/retailCatalog/dtos/responses/InventoryLensResponse.d.ts

@@ -5,6 +5,7 @@ import type { ProductTierEnum } from '../../enums/ProductTierEnum';
 import type { InventoryLensUnavailableReasonEnum } from '../../enums/InventoryLensUnavailableReasonEnum';
 import type { InventoryTransferReasonEnum } from '../../enums/InventoryTransferReasonEnum';
 import type { ItemTypeEnum } from '../../enums/ItemTypeEnum';
+import type { CatalogSourceStatusEnum } from '../../enums/CatalogSourceStatusEnum';
 /**
  * Los contadores que la pantalla «Inventario» del Admin VL pinta arriba, siempre — los cuatro viajan
  * con cualquier `filter`, porque las tarjetas no cambian al cambiar de tab.
@@ -115,6 +116,10 @@ export interface InventoryLensListItem {
     sold30d: number;
     /** Producto físico o servicio. Ausente = PRODUCT. */
     itemType?: ItemTypeEnum;
+    /** Tiene al menos una promo de venta vigente; `null` si retail-promotions no respondió. */
+    hasPromotion?: boolean | null;
+    /** Nombres de sus promos de venta vigentes; `null` si retail-promotions no respondió. */
+    promotionNames?: string[] | null;
 }
 /** Fila del lente — el tipo depende del tab pedido. */
 export type InventoryLensItem = InventoryLensSkuItem | InventoryLensTransferSuggestion | InventoryLensListItem;
@@ -147,4 +152,9 @@ export interface InventoryLensResponse {
     unavailable?: boolean;
     /** Por qué no se pudo. Presente solo junto a `unavailable: true`. */
     reason?: InventoryLensUnavailableReasonEnum;
+    /** Estado de las fuentes externas; solo en el modo `list`. */
+    sources?: InventoryLensSources;
+}
+export interface InventoryLensSources {
+    promotions: CatalogSourceStatusEnum;
 }

package/bin/retailCatalog/enums/CatalogSourceStatusEnum.d.ts

@@ -0,0 +1,5 @@
+/** Si una fuente externa de una respuesta del catálogo contestó (`OK`) o falló (`UNAVAILABLE`). */
+export declare enum CatalogSourceStatusEnum {
+    OK = "OK",
+    UNAVAILABLE = "UNAVAILABLE"
+}

package/bin/retailCatalog/enums/CatalogSourceStatusEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CatalogSourceStatusEnum = void 0;
+/** Si una fuente externa de una respuesta del catálogo contestó (`OK`) o falló (`UNAVAILABLE`). */
+var CatalogSourceStatusEnum;
+(function (CatalogSourceStatusEnum) {
+    CatalogSourceStatusEnum["OK"] = "OK";
+    CatalogSourceStatusEnum["UNAVAILABLE"] = "UNAVAILABLE";
+})(CatalogSourceStatusEnum || (exports.CatalogSourceStatusEnum = CatalogSourceStatusEnum = {}));

package/bin/retailCatalog/index.d.ts

@@ -36,6 +36,7 @@ export * from './enums/InventorySyncResultStatusEnum';
 export * from './enums/InventorySyncRejectionCodeEnum';
 export * from './enums/PriceSourceEnum';
 export * from './enums/InventoryLensPeriodEnum';
+export * from './enums/CatalogSourceStatusEnum';
 export * from './dtos/ProductComponent';
 export * from './dtos/requests/ReservationLineRef';
 export * from './dtos/requests/StockLine';

package/bin/retailCatalog/index.js

@@ -60,6 +60,7 @@ __exportStar(require("./enums/InventorySyncResultStatusEnum"), exports);
 __exportStar(require("./enums/InventorySyncRejectionCodeEnum"), exports);
 __exportStar(require("./enums/PriceSourceEnum"), exports);
 __exportStar(require("./enums/InventoryLensPeriodEnum"), exports);
+__exportStar(require("./enums/CatalogSourceStatusEnum"), exports);
 __exportStar(require("./dtos/ProductComponent"), exports);
 __exportStar(require("./dtos/requests/ReservationLineRef"), exports);
 __exportStar(require("./dtos/requests/StockLine"), exports);

package/bin/retailPromotions/constants/activeSalePromotionsBySkus.d.ts

@@ -0,0 +1,2 @@
+/** Tope de SKUs por llamada a `POST /private/sale-promotions/active-by-skus`; el caller parte en bloques. */
+export declare const ACTIVE_SALE_PROMOTIONS_MAX_SKUS = 100;

package/bin/retailPromotions/constants/activeSalePromotionsBySkus.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACTIVE_SALE_PROMOTIONS_MAX_SKUS = void 0;
+/** Tope de SKUs por llamada a `POST /private/sale-promotions/active-by-skus`; el caller parte en bloques. */
+exports.ACTIVE_SALE_PROMOTIONS_MAX_SKUS = 100;

package/bin/retailPromotions/dtos/requests/ActiveSalePromotionsBySkusRequest.d.ts

@@ -0,0 +1,17 @@
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
+/** Un SKU con su tipo y gama; sin ellos no cumple un alcance por tipo o por gama. */
+export declare class ActiveSalePromotionsSkuInput {
+    /** Un SKU vacío no invalida el lote: sale como `INVALID_ID`. */
+    sku: string;
+    category?: ProductCategoryEnum | null;
+    tier?: ProductTierEnum | null;
+}
+/** Body de `POST /private/sale-promotions/active-by-skus` (M2M): hasta 100 SKUs; los repetidos se cuentan una vez. */
+export declare class ActiveSalePromotionsBySkusRequest {
+    tenantId: string;
+    retailerId: string;
+    /** Con tienda, solo las promos cuyo alcance la incluye; sin ella, las de cualquier tienda. */
+    storeId?: string;
+    items: ActiveSalePromotionsSkuInput[];
+}

package/bin/retailPromotions/dtos/requests/ActiveSalePromotionsBySkusRequest.js

@@ -0,0 +1,69 @@
+"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.ActiveSalePromotionsBySkusRequest = exports.ActiveSalePromotionsSkuInput = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ProductCategoryEnum_1 = require("../../../retailCatalog/enums/ProductCategoryEnum");
+const ProductTierEnum_1 = require("../../../retailCatalog/enums/ProductTierEnum");
+const activeSalePromotionsBySkus_1 = require("../../constants/activeSalePromotionsBySkus");
+/** Un SKU con su tipo y gama; sin ellos no cumple un alcance por tipo o por gama. */
+class ActiveSalePromotionsSkuInput {
+}
+exports.ActiveSalePromotionsSkuInput = ActiveSalePromotionsSkuInput;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ActiveSalePromotionsSkuInput.prototype, "sku", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ProductCategoryEnum_1.ProductCategoryEnum),
+    __metadata("design:type", String)
+], ActiveSalePromotionsSkuInput.prototype, "category", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ProductTierEnum_1.ProductTierEnum),
+    __metadata("design:type", String)
+], ActiveSalePromotionsSkuInput.prototype, "tier", void 0);
+/** Body de `POST /private/sale-promotions/active-by-skus` (M2M): hasta 100 SKUs; los repetidos se cuentan una vez. */
+class ActiveSalePromotionsBySkusRequest {
+}
+exports.ActiveSalePromotionsBySkusRequest = ActiveSalePromotionsBySkusRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ActiveSalePromotionsBySkusRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ActiveSalePromotionsBySkusRequest.prototype, "retailerId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ActiveSalePromotionsBySkusRequest.prototype, "storeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(activeSalePromotionsBySkus_1.ACTIVE_SALE_PROMOTIONS_MAX_SKUS),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => ActiveSalePromotionsSkuInput),
+    __metadata("design:type", Array)
+], ActiveSalePromotionsBySkusRequest.prototype, "items", void 0);

package/bin/retailPromotions/dtos/responses/ActiveSalePromotionsBySkusResponse.d.ts

@@ -0,0 +1,26 @@
+import type { SalePromotionLevers, SalePromotionScope, SalePromotionSegmentation } from '../SalePromotionLevers';
+import type { SkuSalePromotionLookupStatusEnum } from '../../enums/SkuSalePromotionLookupStatusEnum';
+/** Promo de venta vigente hoy que alcanza al SKU, con su contenido de la versión actual. */
+export interface ActiveSalePromotionSummary {
+    promotionId: string;
+    name: string;
+    /** Palancas en español: «$500 de descuento + 3× $50 de tiempo aire + $300 al Wallet Fiado». */
+    benefitSummary: string;
+    levers: SalePromotionLevers;
+    /** `null` = arrancó al publicarse. */
+    validFrom: string | null;
+    /** `null` = permanente. */
+    validUntil: string | null;
+    segmentation: SalePromotionSegmentation;
+    scope: SalePromotionScope;
+}
+export interface SkuActiveSalePromotions {
+    sku: string;
+    status: SkuSalePromotionLookupStatusEnum;
+    /** Vacío si no tiene ninguna o si el estado no es `OK`. */
+    promotions: ActiveSalePromotionSummary[];
+}
+/** Response de `POST /private/sale-promotions/active-by-skus`: una entrada por SKU, en el orden pedido. */
+export interface ActiveSalePromotionsBySkusResponse {
+    items: SkuActiveSalePromotions[];
+}

package/bin/retailPromotions/dtos/responses/ActiveSalePromotionsBySkusResponse.js

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

package/bin/retailPromotions/enums/SkuSalePromotionLookupStatusEnum.d.ts

@@ -0,0 +1,9 @@
+/** Cómo se resolvió cada SKU del lote de promos vigentes; hay una entrada por SKU pedido. */
+export declare enum SkuSalePromotionLookupStatusEnum {
+    /** Se leyeron las promos; `promotions` vacío es un dato: no tiene ninguna vigente. */
+    OK = "OK",
+    /** No se pudieron leer las promos; el caller lo pinta como fuente caída y reintenta. */
+    UNAVAILABLE = "UNAVAILABLE",
+    /** El SKU no tiene forma de SKU; reintentarlo igual nunca sirve. */
+    INVALID_ID = "INVALID_ID"
+}

package/bin/retailPromotions/enums/SkuSalePromotionLookupStatusEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkuSalePromotionLookupStatusEnum = void 0;
+/** Cómo se resolvió cada SKU del lote de promos vigentes; hay una entrada por SKU pedido. */
+var SkuSalePromotionLookupStatusEnum;
+(function (SkuSalePromotionLookupStatusEnum) {
+    /** Se leyeron las promos; `promotions` vacío es un dato: no tiene ninguna vigente. */
+    SkuSalePromotionLookupStatusEnum["OK"] = "OK";
+    /** No se pudieron leer las promos; el caller lo pinta como fuente caída y reintenta. */
+    SkuSalePromotionLookupStatusEnum["UNAVAILABLE"] = "UNAVAILABLE";
+    /** El SKU no tiene forma de SKU; reintentarlo igual nunca sirve. */
+    SkuSalePromotionLookupStatusEnum["INVALID_ID"] = "INVALID_ID";
+})(SkuSalePromotionLookupStatusEnum || (exports.SkuSalePromotionLookupStatusEnum = SkuSalePromotionLookupStatusEnum = {}));

package/bin/retailPromotions/index.d.ts

@@ -17,9 +17,11 @@ export * from './enums/EntitlementKindEnum';
 export * from './enums/SaleCouponAvailabilityEnum';
 export * from './enums/RetailPromotionsErrorCodeEnum';
 export * from './enums/SalePromotionKindEnum';
+export * from './enums/SkuSalePromotionLookupStatusEnum';
 export * from './constants/retailPromotionsErrorHttpStatus';
 export * from './constants/salePromotionTransitions';
 export * from './constants/bonusPreMoney';
+export * from './constants/activeSalePromotionsBySkus';
 export * from './helpers/resolveSalePromotionTransition';
 export * from './helpers/computeBudgetUsedBps';
 export * from './helpers/resolveSalePromotionKind';
@@ -50,8 +52,10 @@ export * from './dtos/requests/HoldPromotionInput';
 export * from './dtos/requests/HoldSalePromotionRequest';
 export * from './dtos/requests/GetSaleCouponQuery';
 export * from './dtos/requests/SkuSalePromotionsQuery';
+export * from './dtos/requests/ActiveSalePromotionsBySkusRequest';
 export * from './dtos/responses/SalePromotionCrudResponses';
 export * from './dtos/responses/DiscountCodeResponses';
 export * from './dtos/responses/WizardSalePromotionResponses';
 export * from './dtos/responses/SkuSalePromotionsResponse';
 export * from './dtos/responses/SalePromotionSegmentsResponse';
+export * from './dtos/responses/ActiveSalePromotionsBySkusResponse';

package/bin/retailPromotions/index.js

@@ -34,10 +34,12 @@ __exportStar(require("./enums/EntitlementKindEnum"), exports);
 __exportStar(require("./enums/SaleCouponAvailabilityEnum"), exports);
 __exportStar(require("./enums/RetailPromotionsErrorCodeEnum"), exports);
 __exportStar(require("./enums/SalePromotionKindEnum"), exports);
+__exportStar(require("./enums/SkuSalePromotionLookupStatusEnum"), exports);
 // Constantes y helpers puros
 __exportStar(require("./constants/retailPromotionsErrorHttpStatus"), exports);
 __exportStar(require("./constants/salePromotionTransitions"), exports);
 __exportStar(require("./constants/bonusPreMoney"), exports);
+__exportStar(require("./constants/activeSalePromotionsBySkus"), exports);
 __exportStar(require("./helpers/resolveSalePromotionTransition"), exports);
 __exportStar(require("./helpers/computeBudgetUsedBps"), exports);
 __exportStar(require("./helpers/resolveSalePromotionKind"), exports);
@@ -71,9 +73,11 @@ __exportStar(require("./dtos/requests/HoldPromotionInput"), exports);
 __exportStar(require("./dtos/requests/HoldSalePromotionRequest"), exports);
 __exportStar(require("./dtos/requests/GetSaleCouponQuery"), exports);
 __exportStar(require("./dtos/requests/SkuSalePromotionsQuery"), exports);
+__exportStar(require("./dtos/requests/ActiveSalePromotionsBySkusRequest"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/SalePromotionCrudResponses"), exports);
 __exportStar(require("./dtos/responses/DiscountCodeResponses"), exports);
 __exportStar(require("./dtos/responses/WizardSalePromotionResponses"), exports);
 __exportStar(require("./dtos/responses/SkuSalePromotionsResponse"), exports);
 __exportStar(require("./dtos/responses/SalePromotionSegmentsResponse"), exports);
+__exportStar(require("./dtos/responses/ActiveSalePromotionsBySkusResponse"), exports);

package/package.json

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

package/src/datalakeReports/dtos/ReportDefinitionDto.ts

@@ -0,0 +1,36 @@
+// Definición de un reporte del datalake (datalake-reports-business). Respuesta: sin validadores.
+export type ReportAudience = 'backoffice' | 'private' | 'public';
+export type ReportParamType = 'date' | 'string' | 'int' | 'enum' | 'list' | 'boolean';
+
+export class ReportParamSpecDto {
+    type: ReportParamType;
+    required?: boolean;
+    default?: string | number | boolean | string[];
+    values?: string[];
+    max?: number;
+    min?: number;
+}
+
+export class ReportColumnDto {
+    name: string;
+    type: 'string' | 'number' | 'date' | 'datetime' | 'boolean';
+    label: string;
+}
+
+export class ReportDefinitionDto {
+    /** dominio.nombre */
+    id: string;
+    version: number;
+    title: string;
+    description: string;
+    source: { layer: 'gold' | 'silver'; databases: string[] };
+    pii: boolean;
+    audiences: ReportAudience[];
+    permission: string;
+    mode: 'sync' | 'async';
+    cacheSeconds: number;
+    maxBytesScanned?: number;
+    params: Record<string, ReportParamSpecDto>;
+    principalParams: string[];
+    columns: ReportColumnDto[];
+}

package/src/datalakeReports/dtos/ReportResultDto.ts

@@ -0,0 +1,20 @@
+import { ReportStatusEnum } from "../enums/ReportStatusEnum";
+import { ReportColumnDto } from "./ReportDefinitionDto";
+
+export type ReportRow = Record<string, string | number | boolean | null>;
+
+/** Respuesta de run y de jobs. Con status RUNNING solo vienen reportId y jobId; con FAILED, jobId y reason. */
+export class ReportResultDto {
+    status: ReportStatusEnum;
+    reportId?: string;
+    version?: number;
+    jobId: string;
+    columns?: ReportColumnDto[];
+    rows?: ReportRow[];
+    rowCount?: number;
+    nextToken?: string;
+    computedAt?: string;
+    fromCache?: boolean;
+    bytesScanned?: number;
+    reason?: string;
+}

package/src/datalakeReports/dtos/RunReportRequest.ts

@@ -0,0 +1,8 @@
+import { IsObject, IsOptional } from "class-validator";
+
+export class RunReportRequest {
+    /** Parámetros del reporte según su definición; los principalParams se ignoran (salen del token). */
+    @IsObject()
+    @IsOptional()
+    params?: Record<string, unknown>;
+}

package/src/datalakeReports/enums/ReportStatusEnum.ts

@@ -0,0 +1,5 @@
+export enum ReportStatusEnum {
+    RUNNING = 'RUNNING',
+    DONE = 'DONE',
+    FAILED = 'FAILED',
+}

package/src/datalakeReports/index.ts

@@ -0,0 +1,7 @@
+//enums
+export * from './enums/ReportStatusEnum';
+
+//dtos
+export * from './dtos/ReportDefinitionDto';
+export * from './dtos/RunReportRequest';
+export * from './dtos/ReportResultDto';

package/src/index.ts

@@ -207,3 +207,4 @@ export * as Rewards from './rewards';
 // RewardsEligibility: contrato del validador de elegibilidad (rewards-eligibility-business) hacia los
 // servicios emisores: POST /events (request/response) y GET /runs/{id}.
 export * as RewardsEligibility from './rewardsEligibility';
+export * as DatalakeReports from './datalakeReports';

package/src/loanCredit/dtos/requests/UpdateLoanBorrowerSciRequest.ts

@@ -0,0 +1,31 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsInt, IsNotEmpty, IsString, Matches, Max, Min } from 'class-validator';
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
+
+/** ULID canónico (Crockford base32 en mayúsculas): solo así la comparación de texto sigue al tiempo. */
+const EVALUATION_ID_PATTERN = /^[0-7][0-9A-HJKMNP-TV-Z]{25}$/;
+
+/**
+ * Body de `PUT /private/borrowers/:borrowerId/sci` (loan-credit-business): el resultado de una
+ * evaluación SCI que loan-scoring deja en el acreditado al terminarla.
+ *
+ * El acreditado guarda la evaluación más reciente: una que llegue después de otra más nueva no
+ * cambia nada. `evaluationId` es el ULID de la evaluación, así que su orden es el cronológico.
+ */
+export class UpdateLoanBorrowerSciRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Matches(EVALUATION_ID_PATTERN, { message: 'evaluationId debe ser un ULID de 26 caracteres' })
+    evaluationId!: string;
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    @Max(100)
+    sciScore!: number;
+
+    @Expose()
+    @IsEnum(ClientLevelEnum)
+    clientLevel!: ClientLevelEnum;
+}

package/src/loanCredit/index.ts

@@ -20,6 +20,7 @@ export * from './dtos/EffectiveTermsSnapshot';
 
 // Request DTOs
 export * from './dtos/requests/UpsertLoanBorrowerRequest';
+export * from './dtos/requests/UpdateLoanBorrowerSciRequest';
 export * from './dtos/requests/OriginateLoanCreditRequest';
 export * from './dtos/requests/QuoteLoanCreditRequest';
 export * from './dtos/requests/SignLoanCreditRequest';

package/src/retailCatalog/dtos/responses/GetInventorySkuResponse.ts

@@ -2,6 +2,8 @@ import type { InventoryItemStatusEnum } from '../../enums/InventoryItemStatusEnu
 import type { InventoryMovementTypeEnum } from '../../enums/InventoryMovementTypeEnum';
 import type { InventoryMovementReasonEnum } from '../../enums/InventoryMovementReasonEnum';
 import type { SkuPriceEntry } from './SkuPriceEntry';
+import type { CatalogSourceStatusEnum } from '../../enums/CatalogSourceStatusEnum';
+import type { ActiveSalePromotionSummary } from '../../../retailPromotions/dtos/responses/ActiveSalePromotionsBySkusResponse';
 
 /** Un movimiento del libro de inventario. */
 export interface InventoryMovementEntry {
@@ -40,4 +42,12 @@ export interface GetInventorySkuResponse {
     /** Vacío si el SKU se rastrea por cantidad. */
     piecesByStore: InventoryStorePieces[];
     currentPrice: SkuPriceEntry | null;
+    /** Promos de venta vigentes del SKU; `null` si retail-promotions no respondió. */
+    promotions?: ActiveSalePromotionSummary[] | null;
+    sources?: InventorySkuSources;
+}
+
+/** Estado de las fuentes externas de la ficha. */
+export interface InventorySkuSources {
+    promotions: CatalogSourceStatusEnum;
 }

package/src/retailCatalog/dtos/responses/InventoryLensResponse.ts

@@ -5,6 +5,7 @@ import type { ProductTierEnum } from '../../enums/ProductTierEnum';
 import type { InventoryLensUnavailableReasonEnum } from '../../enums/InventoryLensUnavailableReasonEnum';
 import type { InventoryTransferReasonEnum } from '../../enums/InventoryTransferReasonEnum';
 import type { ItemTypeEnum } from '../../enums/ItemTypeEnum';
+import type { CatalogSourceStatusEnum } from '../../enums/CatalogSourceStatusEnum';
 
 /**
  * Los contadores que la pantalla «Inventario» del Admin VL pinta arriba, siempre — los cuatro viajan
@@ -130,6 +131,10 @@ export interface InventoryLensListItem {
     sold30d: number;
     /** Producto físico o servicio. Ausente = PRODUCT. */
     itemType?: ItemTypeEnum;
+    /** Tiene al menos una promo de venta vigente; `null` si retail-promotions no respondió. */
+    hasPromotion?: boolean | null;
+    /** Nombres de sus promos de venta vigentes; `null` si retail-promotions no respondió. */
+    promotionNames?: string[] | null;
 }
 
 /** Fila del lente — el tipo depende del tab pedido. */
@@ -169,4 +174,11 @@ export interface InventoryLensResponse {
 
     /** Por qué no se pudo. Presente solo junto a `unavailable: true`. */
     reason?: InventoryLensUnavailableReasonEnum;
+
+    /** Estado de las fuentes externas; solo en el modo `list`. */
+    sources?: InventoryLensSources;
+}
+
+export interface InventoryLensSources {
+    promotions: CatalogSourceStatusEnum;
 }

package/src/retailCatalog/enums/CatalogSourceStatusEnum.ts

@@ -0,0 +1,5 @@
+/** Si una fuente externa de una respuesta del catálogo contestó (`OK`) o falló (`UNAVAILABLE`). */
+export enum CatalogSourceStatusEnum {
+    OK = 'OK',
+    UNAVAILABLE = 'UNAVAILABLE',
+}

package/src/retailCatalog/index.ts

@@ -52,6 +52,7 @@ export * from './enums/InventorySyncResultStatusEnum';
 export * from './enums/InventorySyncRejectionCodeEnum';
 export * from './enums/PriceSourceEnum';
 export * from './enums/InventoryLensPeriodEnum';
+export * from './enums/CatalogSourceStatusEnum';
 export * from './dtos/ProductComponent';
 export * from './dtos/requests/ReservationLineRef';
 export * from './dtos/requests/StockLine';

package/src/retailPromotions/constants/activeSalePromotionsBySkus.ts

@@ -0,0 +1,2 @@
+/** Tope de SKUs por llamada a `POST /private/sale-promotions/active-by-skus`; el caller parte en bloques. */
+export const ACTIVE_SALE_PROMOTIONS_MAX_SKUS = 100;

package/src/retailPromotions/dtos/requests/ActiveSalePromotionsBySkusRequest.ts

@@ -0,0 +1,50 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsEnum, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
+import { ACTIVE_SALE_PROMOTIONS_MAX_SKUS } from '../../constants/activeSalePromotionsBySkus';
+
+/** Un SKU con su tipo y gama; sin ellos no cumple un alcance por tipo o por gama. */
+export class ActiveSalePromotionsSkuInput {
+    /** Un SKU vacío no invalida el lote: sale como `INVALID_ID`. */
+    @Expose()
+    @IsString()
+    sku!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductCategoryEnum)
+    category?: ProductCategoryEnum | null;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductTierEnum)
+    tier?: ProductTierEnum | null;
+}
+
+/** Body de `POST /private/sale-promotions/active-by-skus` (M2M): hasta 100 SKUs; los repetidos se cuentan una vez. */
+export class ActiveSalePromotionsBySkusRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    tenantId!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    retailerId!: string;
+
+    /** Con tienda, solo las promos cuyo alcance la incluye; sin ella, las de cualquier tienda. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    storeId?: string;
+
+    @Expose()
+    @IsArray()
+    @ArrayMaxSize(ACTIVE_SALE_PROMOTIONS_MAX_SKUS)
+    @ValidateNested({ each: true })
+    @Type(() => ActiveSalePromotionsSkuInput)
+    items!: ActiveSalePromotionsSkuInput[];
+}

package/src/retailPromotions/dtos/responses/ActiveSalePromotionsBySkusResponse.ts

@@ -0,0 +1,29 @@
+import type { SalePromotionLevers, SalePromotionScope, SalePromotionSegmentation } from '../SalePromotionLevers';
+import type { SkuSalePromotionLookupStatusEnum } from '../../enums/SkuSalePromotionLookupStatusEnum';
+
+/** Promo de venta vigente hoy que alcanza al SKU, con su contenido de la versión actual. */
+export interface ActiveSalePromotionSummary {
+    promotionId: string;
+    name: string;
+    /** Palancas en español: «$500 de descuento + 3× $50 de tiempo aire + $300 al Wallet Fiado». */
+    benefitSummary: string;
+    levers: SalePromotionLevers;
+    /** `null` = arrancó al publicarse. */
+    validFrom: string | null;
+    /** `null` = permanente. */
+    validUntil: string | null;
+    segmentation: SalePromotionSegmentation;
+    scope: SalePromotionScope;
+}
+
+export interface SkuActiveSalePromotions {
+    sku: string;
+    status: SkuSalePromotionLookupStatusEnum;
+    /** Vacío si no tiene ninguna o si el estado no es `OK`. */
+    promotions: ActiveSalePromotionSummary[];
+}
+
+/** Response de `POST /private/sale-promotions/active-by-skus`: una entrada por SKU, en el orden pedido. */
+export interface ActiveSalePromotionsBySkusResponse {
+    items: SkuActiveSalePromotions[];
+}

package/src/retailPromotions/enums/SkuSalePromotionLookupStatusEnum.ts

@@ -0,0 +1,9 @@
+/** Cómo se resolvió cada SKU del lote de promos vigentes; hay una entrada por SKU pedido. */
+export enum SkuSalePromotionLookupStatusEnum {
+    /** Se leyeron las promos; `promotions` vacío es un dato: no tiene ninguna vigente. */
+    OK = 'OK',
+    /** No se pudieron leer las promos; el caller lo pinta como fuente caída y reintenta. */
+    UNAVAILABLE = 'UNAVAILABLE',
+    /** El SKU no tiene forma de SKU; reintentarlo igual nunca sirve. */
+    INVALID_ID = 'INVALID_ID',
+}

package/src/retailPromotions/index.ts

@@ -18,11 +18,13 @@ export * from './enums/EntitlementKindEnum';
 export * from './enums/SaleCouponAvailabilityEnum';
 export * from './enums/RetailPromotionsErrorCodeEnum';
 export * from './enums/SalePromotionKindEnum';
+export * from './enums/SkuSalePromotionLookupStatusEnum';
 
 // Constantes y helpers puros
 export * from './constants/retailPromotionsErrorHttpStatus';
 export * from './constants/salePromotionTransitions';
 export * from './constants/bonusPreMoney';
+export * from './constants/activeSalePromotionsBySkus';
 export * from './helpers/resolveSalePromotionTransition';
 export * from './helpers/computeBudgetUsedBps';
 export * from './helpers/resolveSalePromotionKind';
@@ -59,6 +61,7 @@ export * from './dtos/requests/HoldPromotionInput';
 export * from './dtos/requests/HoldSalePromotionRequest';
 export * from './dtos/requests/GetSaleCouponQuery';
 export * from './dtos/requests/SkuSalePromotionsQuery';
+export * from './dtos/requests/ActiveSalePromotionsBySkusRequest';
 
 // Response DTOs
 export * from './dtos/responses/SalePromotionCrudResponses';
@@ -66,3 +69,4 @@ export * from './dtos/responses/DiscountCodeResponses';
 export * from './dtos/responses/WizardSalePromotionResponses';
 export * from './dtos/responses/SkuSalePromotionsResponse';
 export * from './dtos/responses/SalePromotionSegmentsResponse';
+export * from './dtos/responses/ActiveSalePromotionsBySkusResponse';