@fiado/type-kit 3.275.0 → 3.277.0

package/bin/biometrics/dtos/BiometricDelivery.d.ts

@@ -22,6 +22,37 @@ export declare class RedirectDelivery {
     /** Hasta cuándo sirve el link. ISO-8601 UTC con `Z`. */
     expiresAt: string;
 }
+/**
+ * `deliveryMode = EMBEDDED_SDK`. El caller monta el SDK del proveedor **en su propia pantalla** con
+ * estos parámetros, en vez de mandar al usuario a un link hospedado.
+ *
+ * Para qué: hay flujos donde el usuario está PRESENTE frente a un dispositivo que no es el suyo —el
+ * vendedor le pasa la tablet de la tienda— y sacarlo a un navegador externo rompe la atención.
+ * Mismo biométrico y mismo veredicto que `REDIRECT`; lo único distinto es dónde corre.
+ *
+ * ⚠️ **Ninguno de los tres campos es secreto.** El `clientId` y el `flowId` viajan al navegador como
+ * parámetros del widget y se leen en el inspector; el `metadata` lo devuelve el proveedor tal cual
+ * en cada webhook. Lo que SÍ es secreto —el Client Secret con el que se firma el
+ * `userPhotoLinkHash`— nunca sale de `metamap-connector` y no viaja acá.
+ */
+export declare class EmbeddedSdkDelivery {
+    /** `merchantToken` del proveedor. Público: viaja al navegador. */
+    clientId: string;
+    /** El flow del proveedor a ejecutar. Sale del catálogo, no de una env var del caller. */
+    flowId: string;
+    /**
+     * El `metadata` ya serializado, **listo para pasárselo al SDK tal cual**.
+     *
+     * 🔴 Es un JSON string, NO un objeto y NO base64. El proveedor lo devuelve literal en cada
+     * webhook y es el único canal de correlación que existe. Si el caller lo re-serializa o lo
+     * codifica, el `userPhotoLink` que el proveedor reconstruye deja de ser idéntico al que se
+     * firmó, el hash del facematch no cuadra, y rechaza la verificación con «Invalid hash or url»
+     * DESPUÉS de que el usuario ya se tomó la selfie. Pasarlo sin tocarlo.
+     */
+    metadata: string;
+    /** Hasta cuándo sirven estos parámetros. ISO-8601 UTC con `Z`. */
+    expiresAt: string;
+}
 /**
  * `deliveryMode = CHALLENGE`. El biométrico corre en el dispositivo (Apple Face ID, biometría de
  * Android) y el cliente devuelve una attestation firmada.
@@ -56,10 +87,11 @@ export declare class ImmediateDelivery {
  *
  * ```ts
  * switch (res.deliveryMode) {
- *   case BiometricDeliveryModeEnum.REDIRECT:  abrir((res.delivery as RedirectDelivery).link); break;
- *   case BiometricDeliveryModeEnum.CHALLENGE: firmar(res.delivery as ChallengeDelivery); break;
- *   case BiometricDeliveryModeEnum.IMMEDIATE: leer(res.result); break;
+ *   case BiometricDeliveryModeEnum.REDIRECT:     abrir((res.delivery as RedirectDelivery).link); break;
+ *   case BiometricDeliveryModeEnum.EMBEDDED_SDK: montarSdk(res.delivery as EmbeddedSdkDelivery); break;
+ *   case BiometricDeliveryModeEnum.CHALLENGE:    firmar(res.delivery as ChallengeDelivery); break;
+ *   case BiometricDeliveryModeEnum.IMMEDIATE:    leer(res.result); break;
  * }
  * ```
  */
-export type BiometricDelivery = RedirectDelivery | ChallengeDelivery | ImmediateDelivery;
+export type BiometricDelivery = RedirectDelivery | EmbeddedSdkDelivery | ChallengeDelivery | ImmediateDelivery;

package/bin/biometrics/dtos/BiometricDelivery.js

@@ -9,7 +9,7 @@ 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.ImmediateDelivery = exports.ChallengeDelivery = exports.RedirectDelivery = void 0;
+exports.ImmediateDelivery = exports.ChallengeDelivery = exports.EmbeddedSdkDelivery = exports.RedirectDelivery = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 /**
@@ -41,6 +41,45 @@ __decorate([
     (0, class_validator_1.IsISO8601)({ strict: true }),
     __metadata("design:type", String)
 ], RedirectDelivery.prototype, "expiresAt", void 0);
+/**
+ * `deliveryMode = EMBEDDED_SDK`. El caller monta el SDK del proveedor **en su propia pantalla** con
+ * estos parámetros, en vez de mandar al usuario a un link hospedado.
+ *
+ * Para qué: hay flujos donde el usuario está PRESENTE frente a un dispositivo que no es el suyo —el
+ * vendedor le pasa la tablet de la tienda— y sacarlo a un navegador externo rompe la atención.
+ * Mismo biométrico y mismo veredicto que `REDIRECT`; lo único distinto es dónde corre.
+ *
+ * ⚠️ **Ninguno de los tres campos es secreto.** El `clientId` y el `flowId` viajan al navegador como
+ * parámetros del widget y se leen en el inspector; el `metadata` lo devuelve el proveedor tal cual
+ * en cada webhook. Lo que SÍ es secreto —el Client Secret con el que se firma el
+ * `userPhotoLinkHash`— nunca sale de `metamap-connector` y no viaja acá.
+ */
+class EmbeddedSdkDelivery {
+}
+exports.EmbeddedSdkDelivery = EmbeddedSdkDelivery;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], EmbeddedSdkDelivery.prototype, "clientId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], EmbeddedSdkDelivery.prototype, "flowId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], EmbeddedSdkDelivery.prototype, "metadata", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsISO8601)({ strict: true }),
+    __metadata("design:type", String)
+], EmbeddedSdkDelivery.prototype, "expiresAt", void 0);
 /**
  * `deliveryMode = CHALLENGE`. El biométrico corre en el dispositivo (Apple Face ID, biometría de
  * Android) y el cliente devuelve una attestation firmada.

package/bin/biometrics/dtos/requests/CreateBiometricVerificationRequest.d.ts

@@ -1,3 +1,4 @@
+import { BiometricDeliveryModeEnum } from '../../enums/BiometricDeliveryModeEnum';
 import { BiometricProviderEnum } from '../../enums/BiometricProviderEnum';
 import { BiometricTypeEnum } from '../../enums/BiometricTypeEnum';
 import { BiometricSubject } from '../BiometricSubject';
@@ -70,4 +71,21 @@ export declare class CreateBiometricVerificationRequest {
      * sesión, de orden, de lo que sea que estés correlacionando.
      */
     callerContext?: string;
+    /**
+     * CÓMO quieres recibir lo que hace falta para ejecutar el biométrico. Default `REDIRECT`.
+     *
+     * Es una **preferencia, no una orden**: el servicio responde con el modo que el proveedor
+     * elegido soporta de verdad, y el modo real siempre viene en `deliveryMode` de la respuesta.
+     * Nunca asumas que te tocó el que pediste — discrimina por el de la respuesta.
+     *
+     * Con `METAMAP` hoy:
+     * - `REDIRECT` → link hospedado y acortado. Para mandárselo al usuario a SU dispositivo.
+     * - `EMBEDDED_SDK` → los parámetros para montar el widget en TU pantalla. Para cuando el
+     *   usuario está presente frente a un dispositivo que no es el suyo.
+     *
+     * Pedir un modo que el proveedor no soporta responde `422 DELIVERY_MODE_NOT_SUPPORTED` — no se
+     * degrada en silencio al default, porque el caller que pidió SDK y recibe un link no tiene
+     * dónde montarlo y se entera hasta que la pantalla queda en blanco.
+     */
+    deliveryMode?: BiometricDeliveryModeEnum;
 }

package/bin/biometrics/dtos/requests/CreateBiometricVerificationRequest.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateBiometricVerificationRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const BiometricDeliveryModeEnum_1 = require("../../enums/BiometricDeliveryModeEnum");
 const BiometricProviderEnum_1 = require("../../enums/BiometricProviderEnum");
 const BiometricTypeEnum_1 = require("../../enums/BiometricTypeEnum");
 const BiometricSubject_1 = require("../BiometricSubject");
@@ -79,3 +80,9 @@ __decorate([
     (0, class_validator_1.MaxLength)(256),
     __metadata("design:type", String)
 ], CreateBiometricVerificationRequest.prototype, "callerContext", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(BiometricDeliveryModeEnum_1.BiometricDeliveryModeEnum),
+    __metadata("design:type", String)
+], CreateBiometricVerificationRequest.prototype, "deliveryMode", void 0);

package/bin/biometrics/enums/BiometricDeliveryModeEnum.d.ts

@@ -17,11 +17,24 @@
  *
  * El `GET` de polling NO cambia entre modos: devuelve estado, no mecanismo.
  *
- * `biometrics-business` — Entrega 1 (solo `REDIRECT` produce valores reales).
+ * `biometrics-business` — Entrega 1: `REDIRECT` y `EMBEDDED_SDK` producen valores reales.
  */
 export declare enum BiometricDeliveryModeEnum {
     /** `delivery` trae `{ link, expiresAt }`. El usuario abre el link y ejecuta ahí. */
     REDIRECT = "REDIRECT",
+    /**
+     * `delivery` trae `{ clientId, flowId, metadata, expiresAt }`. El caller monta el SDK del
+     * proveedor **en su propia pantalla** con esos parámetros, en vez de mandar al usuario a un
+     * link hospedado.
+     *
+     * Existe porque hay flujos donde el usuario está PRESENTE frente a un dispositivo que no es el
+     * suyo — el vendedor le pasa la tablet de la tienda — y sacarlo a un navegador externo rompe la
+     * atención. Mismo biométrico, mismo veredicto, distinta superficie.
+     *
+     * Es exactamente lo que hoy arma a mano `retail-wizard-business` para su modalidad
+     * `STORE_DEVICE`; este modo existe para que deje de armarlo.
+     */
+    EMBEDDED_SDK = "EMBEDDED_SDK",
     /** `delivery` trae `{ challenge, nonce, expiresAt }`. El dispositivo firma y devuelve. */
     CHALLENGE = "CHALLENGE",
     /** `delivery` viene vacío: el biométrico ya corrió y `result` viene poblado en la misma respuesta. */

package/bin/biometrics/enums/BiometricDeliveryModeEnum.js

@@ -20,12 +20,25 @@ exports.BiometricDeliveryModeEnum = void 0;
  *
  * El `GET` de polling NO cambia entre modos: devuelve estado, no mecanismo.
  *
- * `biometrics-business` — Entrega 1 (solo `REDIRECT` produce valores reales).
+ * `biometrics-business` — Entrega 1: `REDIRECT` y `EMBEDDED_SDK` producen valores reales.
  */
 var BiometricDeliveryModeEnum;
 (function (BiometricDeliveryModeEnum) {
     /** `delivery` trae `{ link, expiresAt }`. El usuario abre el link y ejecuta ahí. */
     BiometricDeliveryModeEnum["REDIRECT"] = "REDIRECT";
+    /**
+     * `delivery` trae `{ clientId, flowId, metadata, expiresAt }`. El caller monta el SDK del
+     * proveedor **en su propia pantalla** con esos parámetros, en vez de mandar al usuario a un
+     * link hospedado.
+     *
+     * Existe porque hay flujos donde el usuario está PRESENTE frente a un dispositivo que no es el
+     * suyo — el vendedor le pasa la tablet de la tienda — y sacarlo a un navegador externo rompe la
+     * atención. Mismo biométrico, mismo veredicto, distinta superficie.
+     *
+     * Es exactamente lo que hoy arma a mano `retail-wizard-business` para su modalidad
+     * `STORE_DEVICE`; este modo existe para que deje de armarlo.
+     */
+    BiometricDeliveryModeEnum["EMBEDDED_SDK"] = "EMBEDDED_SDK";
     /** `delivery` trae `{ challenge, nonce, expiresAt }`. El dispositivo firma y devuelve. */
     BiometricDeliveryModeEnum["CHALLENGE"] = "CHALLENGE";
     /** `delivery` viene vacío: el biométrico ya corrió y `result` viene poblado en la misma respuesta. */

package/bin/helpdesk/dtos/ZendeskInternalAlertRequest.d.ts

@@ -11,8 +11,14 @@ export declare class ZendeskInternalAlertRequest {
     directoryId: string;
     /** Detalle del problema. Acá va lo sensible: es lo que se escribe como nota interna. */
     note: string;
-    /** Decide el ruteo en Zendesk (tag, vista y equipo). */
-    channel: InternalAlertChannel;
+    /**
+     * Equipos que deben ver la alerta. Un mismo hecho puede requerir a los dos: por ejemplo un
+     * status de verificación que Compliance evalúa y el equipo interno corrige.
+     *
+     * Los hilos se agrupan por combinación exacta: una alerta `[COMPLIANCE]` no cae en el ticket
+     * de `[INTERNAL, COMPLIANCE]`, para que restringir un canal por rol siga siendo posible.
+     */
+    channels: InternalAlertChannel[];
     /** Id del evento origen, para rastrear la alerta de vuelta. */
     reference?: string;
 }

package/bin/helpdesk/dtos/ZendeskInternalAlertRequest.js

@@ -33,9 +33,11 @@ __decorate([
     __metadata("design:type", String)
 ], ZendeskInternalAlertRequest.prototype, "note", void 0);
 __decorate([
-    (0, class_validator_1.IsEnum)(InternalAlertChannelEnum_1.InternalAlertChannel),
-    __metadata("design:type", String)
-], ZendeskInternalAlertRequest.prototype, "channel", void 0);
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.IsEnum)(InternalAlertChannelEnum_1.InternalAlertChannel, { each: true }),
+    __metadata("design:type", Array)
+], ZendeskInternalAlertRequest.prototype, "channels", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsOptional)(),

package/bin/retailOrg/dtos/GoalAmounts.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Las tres cifras de una meta — y las tres salen de UNA SOLA captura.
+ *
+ * 🔴 Solo `monthCents` se guarda. `weekCents` (`mes/4`) y `dayCents` (`mes/28`) las DERIVA el backend
+ * en cada lectura, y por eso `PUT /backoffice/goals` las RECHAZA si vienen en el request: aceptarlas
+ * del cliente abre la puerta a que lleguen desincronizadas entre sí y a que dos pantallas midan el
+ * mismo avance contra números distintos.
+ *
+ * Se devuelven ya calculadas para que ninguna pantalla repita la división.
+ */
+export interface GoalAmounts {
+    /** La meta mensual en centavos — lo único persistido. */
+    monthCents: number;
+    /** Derivada: `monthCents / 4`, redondeada. */
+    weekCents: number;
+    /** Derivada: `monthCents / 28`, redondeada. */
+    dayCents: number;
+}

package/bin/retailOrg/dtos/GoalAmounts.js

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

package/bin/retailOrg/dtos/requests/GoalListQuery.d.ts

@@ -0,0 +1,16 @@
+import { GoalTargetTypeEnum } from '../../enums/GoalTargetTypeEnum';
+/**
+ * Query de `GET /backoffice/goals` — las metas de un periodo.
+ *
+ * ⚠️ `retailerId` NO es parámetro: sale del token (D10). Un `?retailerId=` en el request se ignora a
+ * propósito — aceptarlo dejaría que un Admin VL mire las metas de la cadena de al lado.
+ */
+export declare class GoalListQuery {
+    /**
+     * Mes calendario `YYYY-MM`. El regex acota el mes a 01-12: `\d{2}` a secas aceptaría `2026-13`,
+     * que escribiría una partición que ninguna consulta vuelve a encontrar.
+     */
+    periodId: string;
+    /** Si falta, devuelve los dos tipos — el `begins_with` del periodo ya los trae juntos. */
+    targetType?: GoalTargetTypeEnum;
+}

package/bin/retailOrg/dtos/requests/GoalListQuery.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.GoalListQuery = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const GoalTargetTypeEnum_1 = require("../../enums/GoalTargetTypeEnum");
+/**
+ * Query de `GET /backoffice/goals` — las metas de un periodo.
+ *
+ * ⚠️ `retailerId` NO es parámetro: sale del token (D10). Un `?retailerId=` en el request se ignora a
+ * propósito — aceptarlo dejaría que un Admin VL mire las metas de la cadena de al lado.
+ */
+class GoalListQuery {
+}
+exports.GoalListQuery = GoalListQuery;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Matches)(/^\d{4}-(0[1-9]|1[0-2])$/, { message: 'periodId debe tener formato YYYY-MM (mes 01-12)' }),
+    __metadata("design:type", String)
+], GoalListQuery.prototype, "periodId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(GoalTargetTypeEnum_1.GoalTargetTypeEnum),
+    __metadata("design:type", String)
+], GoalListQuery.prototype, "targetType", void 0);

package/bin/retailOrg/dtos/requests/GoalPathParams.d.ts

@@ -0,0 +1,14 @@
+import { GoalTargetTypeEnum } from '../../enums/GoalTargetTypeEnum';
+/**
+ * Path params de `DELETE /backoffice/goals/{periodId}/{targetType}/{targetId}`.
+ *
+ * Una meta NO tiene id propio: se identifica por la terna *(periodo, tipo, target)*, que es
+ * exactamente su sort key. Por eso los tres van en el path y por eso hay un DTO para validarlos —
+ * un `targetType` fuera del enum arma una sk que nunca matchea y devolvería un 404 mentiroso en vez
+ * del 400 que corresponde.
+ */
+export declare class GoalPathParams {
+    periodId: string;
+    targetType: GoalTargetTypeEnum;
+    targetId: string;
+}

package/bin/retailOrg/dtos/requests/GoalPathParams.js

@@ -0,0 +1,41 @@
+"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.GoalPathParams = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const GoalTargetTypeEnum_1 = require("../../enums/GoalTargetTypeEnum");
+/**
+ * Path params de `DELETE /backoffice/goals/{periodId}/{targetType}/{targetId}`.
+ *
+ * Una meta NO tiene id propio: se identifica por la terna *(periodo, tipo, target)*, que es
+ * exactamente su sort key. Por eso los tres van en el path y por eso hay un DTO para validarlos —
+ * un `targetType` fuera del enum arma una sk que nunca matchea y devolvería un 404 mentiroso en vez
+ * del 400 que corresponde.
+ */
+class GoalPathParams {
+}
+exports.GoalPathParams = GoalPathParams;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Matches)(/^\d{4}-(0[1-9]|1[0-2])$/, { message: 'periodId debe tener formato YYYY-MM (mes 01-12)' }),
+    __metadata("design:type", String)
+], GoalPathParams.prototype, "periodId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(GoalTargetTypeEnum_1.GoalTargetTypeEnum),
+    __metadata("design:type", String)
+], GoalPathParams.prototype, "targetType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], GoalPathParams.prototype, "targetId", void 0);

package/bin/retailOrg/dtos/requests/GoalUpsertRequest.d.ts

@@ -0,0 +1,34 @@
+import { GoalTargetTypeEnum } from '../../enums/GoalTargetTypeEnum';
+/** Una meta del lote. */
+export declare class GoalUpsertTarget {
+    /** ULID de la tienda o del vendedor. */
+    targetId: string;
+    targetType: GoalTargetTypeEnum;
+    /**
+     * La meta MENSUAL en centavos — lo único que se guarda.
+     *
+     * 🔴 `0` NO borra: cero significa «la meta es cero» y rompe el `goalPct` con una división entre
+     * cero. Para quitar una meta está `DELETE /backoffice/goals/{periodId}/{targetType}/{targetId}`;
+     * sin fila significa «no se fijó» y la UI pinta `—`.
+     */
+    monthCents: number;
+}
+/**
+ * Body de `PUT /backoffice/goals` — upsert POR LOTE de las metas de un periodo.
+ *
+ * ⚠️ `weekCents` y `dayCents` NO están declarados a propósito, y el manager los RECHAZA con 400 si
+ * llegan: son derivadas (`mes/4`, `mes/28`). El `@Expose()` + `excludeExtraneousValues` los
+ * descartaría en silencio, y un descarte silencioso sobre un número contra el que se le paga a la
+ * gente es peor que un error — el cliente creería que los guardó.
+ */
+export declare class GoalUpsertRequest {
+    /** Mes calendario `YYYY-MM`, mes acotado a 01-12. */
+    periodId: string;
+    /**
+     * El lote: 1..50 metas.
+     *
+     * 🔴 El tope es 50, no 100: `TransactWriteItems` acepta 100 ítems y **cada meta consume dos** (la
+     * fila de la meta + su fila de auditoría, que va en la MISMA transacción).
+     */
+    targets: GoalUpsertTarget[];
+}

package/bin/retailOrg/dtos/requests/GoalUpsertRequest.js

@@ -0,0 +1,60 @@
+"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.GoalUpsertRequest = exports.GoalUpsertTarget = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const GoalTargetTypeEnum_1 = require("../../enums/GoalTargetTypeEnum");
+/** Una meta del lote. */
+class GoalUpsertTarget {
+}
+exports.GoalUpsertTarget = GoalUpsertTarget;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], GoalUpsertTarget.prototype, "targetId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(GoalTargetTypeEnum_1.GoalTargetTypeEnum),
+    __metadata("design:type", String)
+], GoalUpsertTarget.prototype, "targetType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], GoalUpsertTarget.prototype, "monthCents", void 0);
+/**
+ * Body de `PUT /backoffice/goals` — upsert POR LOTE de las metas de un periodo.
+ *
+ * ⚠️ `weekCents` y `dayCents` NO están declarados a propósito, y el manager los RECHAZA con 400 si
+ * llegan: son derivadas (`mes/4`, `mes/28`). El `@Expose()` + `excludeExtraneousValues` los
+ * descartaría en silencio, y un descarte silencioso sobre un número contra el que se le paga a la
+ * gente es peor que un error — el cliente creería que los guardó.
+ */
+class GoalUpsertRequest {
+}
+exports.GoalUpsertRequest = GoalUpsertRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Matches)(/^\d{4}-(0[1-9]|1[0-2])$/, { message: 'periodId debe tener formato YYYY-MM (mes 01-12)' }),
+    __metadata("design:type", String)
+], GoalUpsertRequest.prototype, "periodId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(50),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => GoalUpsertTarget),
+    __metadata("design:type", Array)
+], GoalUpsertRequest.prototype, "targets", void 0);

package/bin/retailOrg/dtos/requests/KpiQuery.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Query compartido por los dos drawers de KPIs del Portal Admin VL
+ * (`GET /backoffice/stores/{storeId}/kpis` y `GET /backoffice/sellers/{sellerId}/kpis`).
+ *
+ * `periodId` es OPCIONAL: sin él se usa el mes en curso — el drawer se abre sin elegir periodo.
+ */
+export declare class KpiQuery {
+    periodId?: string;
+}

package/bin/retailOrg/dtos/requests/KpiQuery.js

@@ -0,0 +1,29 @@
+"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.KpiQuery = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Query compartido por los dos drawers de KPIs del Portal Admin VL
+ * (`GET /backoffice/stores/{storeId}/kpis` y `GET /backoffice/sellers/{sellerId}/kpis`).
+ *
+ * `periodId` es OPCIONAL: sin él se usa el mes en curso — el drawer se abre sin elegir periodo.
+ */
+class KpiQuery {
+}
+exports.KpiQuery = KpiQuery;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Matches)(/^\d{4}-(0[1-9]|1[0-2])$/, { message: 'periodId debe tener formato YYYY-MM (mes 01-12)' }),
+    __metadata("design:type", String)
+], KpiQuery.prototype, "periodId", void 0);

package/bin/retailOrg/dtos/requests/PrivateSellerListQuery.d.ts

@@ -0,0 +1,27 @@
+import { RetailUserStatusEnum } from '../../enums/RetailUserStatusEnum';
+/**
+ * Query de `GET /private/sellers` — el padrón de una cadena, M2M.
+ *
+ * 🔴 Acá el `retailerId` **viene en el request**, al revés que en los `/backoffice/` (donde se impone
+ * desde el token). Es el modelo M2M de la casa: el endpoint es VPC-only y su seguridad es de RED, no
+ * de identidad. Cualquier lambda dentro de la VPC puede pedir cualquier retailer — decisión
+ * consciente, no un descuido.
+ */
+export declare class PrivateSellerListQuery {
+    retailerId: string;
+    /**
+     * ⚠️ **Sin `status` vienen TODOS los estados, no solo los activos.**
+     *
+     * El diseño original proponía default `ACTIVE`, pero con este enum eso deja al motor de comisiones
+     * sin ninguna forma de pedir el padrón completo — y un vendedor dado de baja el día 20 sí tiene
+     * comisión por lo que vendió hasta el 19. Filtrar por default sería perderlo en silencio.
+     */
+    status?: RetailUserStatusEnum;
+    /**
+     * Quién llama. `Feature.ANONIMUS` no trae actor, y este endpoint exporta la nómina completa de una
+     * cadena: sin esto el registro de acceso a PII quedaría sin nadie a quien atribuírselo. Lo llena el
+     * publisher de `@fiado/api-invoker`; si falta, el lambda registra `m2m:unknown` y loguea un WARN —
+     * nunca omite el registro.
+     */
+    callerService?: string;
+}

package/bin/retailOrg/dtos/requests/PrivateSellerListQuery.js

@@ -0,0 +1,45 @@
+"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.PrivateSellerListQuery = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const RetailUserStatusEnum_1 = require("../../enums/RetailUserStatusEnum");
+/** ULID canónico: 26 chars Crockford base32, primer char 0-7 (el timestamp cabe en 48 bits). */
+const ULID = /^[0-7][0-9A-HJKMNP-TV-Z]{25}$/;
+/**
+ * Query de `GET /private/sellers` — el padrón de una cadena, M2M.
+ *
+ * 🔴 Acá el `retailerId` **viene en el request**, al revés que en los `/backoffice/` (donde se impone
+ * desde el token). Es el modelo M2M de la casa: el endpoint es VPC-only y su seguridad es de RED, no
+ * de identidad. Cualquier lambda dentro de la VPC puede pedir cualquier retailer — decisión
+ * consciente, no un descuido.
+ */
+class PrivateSellerListQuery {
+}
+exports.PrivateSellerListQuery = PrivateSellerListQuery;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.Matches)(ULID, { message: 'retailerId debe ser un ULID' }),
+    __metadata("design:type", String)
+], PrivateSellerListQuery.prototype, "retailerId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(RetailUserStatusEnum_1.RetailUserStatusEnum),
+    __metadata("design:type", String)
+], PrivateSellerListQuery.prototype, "status", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Matches)(/^[a-z0-9-]{1,64}$/, { message: 'callerService debe ser el nombre del lambda (kebab-case)' }),
+    __metadata("design:type", String)
+], PrivateSellerListQuery.prototype, "callerService", void 0);

package/bin/retailOrg/dtos/responses/GoalListResponse.d.ts

@@ -0,0 +1,18 @@
+import type { GoalAmounts } from '../GoalAmounts';
+import type { GoalTargetTypeEnum } from '../../enums/GoalTargetTypeEnum';
+/** Una meta del periodo, con las tres cifras ya derivadas. */
+export interface GoalDto extends GoalAmounts {
+    targetId: string;
+    targetType: GoalTargetTypeEnum;
+}
+/**
+ * Respuesta de `GET /backoffice/goals`.
+ *
+ * ⚠️ Un periodo sin metas devuelve `goals: []`, **no un 404**: que no se hayan fijado es un estado
+ * válido del negocio, no una ruta que no existe. Y una meta borrada simplemente no viene en la
+ * lista — no hay estado «borrada», la fila deja de existir.
+ */
+export interface GoalListResponse {
+    periodId: string;
+    goals: GoalDto[];
+}

package/bin/retailOrg/dtos/responses/GoalListResponse.js

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

package/bin/retailOrg/dtos/responses/GoalUpsertResponse.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Respuesta de `PUT /backoffice/goals` — cuántas metas quedaron escritas.
+ *
+ * `updated` siempre iguala `targets.length` del request: el lote es todo-o-nada (una sola
+ * `TransactWriteItems`). Nunca hay un lote parcial que explicar.
+ */
+export interface GoalUpsertResponse {
+    periodId: string;
+    updated: number;
+}

package/bin/retailOrg/dtos/responses/GoalUpsertResponse.js

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