@fiado/type-kit 3.279.0 → 3.280.0

package/bin/retailCommission/dtos/CommissionPlan.d.ts

@@ -0,0 +1,182 @@
+import type { CommissionMechanicTypeEnum } from '../enums/CommissionMechanicTypeEnum';
+import type { CommissionPlanStatusEnum } from '../enums/CommissionPlanStatusEnum';
+import type { CommissionPriceReferenceEnum } from '../enums/CommissionPriceReferenceEnum';
+import type { CommissionQuotaTypeEnum } from '../enums/CommissionQuotaTypeEnum';
+import type { CommissionQuotaMeasureEnum } from '../enums/CommissionQuotaMeasureEnum';
+import type { CommissionQuotaSubjectEnum } from '../enums/CommissionQuotaSubjectEnum';
+import type { CommissionQuotaModeEnum } from '../enums/CommissionQuotaModeEnum';
+import type { CommissionPeriodTypeEnum } from '../enums/CommissionPeriodTypeEnum';
+import type { CommissionExceptionTypeEnum } from '../enums/CommissionExceptionTypeEnum';
+/**
+ * El plan de comisiones de VentasLuga, versionado por snapshot inmutable.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Todo lo de este archivo vive DENTRO de un snapshot: se congela al publicar y no se vuelve a tocar.
+ * Esa es la razón de que hasta las reglas de `sku → categoría` (`CommissionCategoryMatch`) vivan acá
+ * y no en el código del motor — si vivieran en el código, un redespliegue cambiaría montos ya
+ * devengados y dos accruals del mismo snapshot podrían calcularse distinto.
+ *
+ * Montos en centavos (`*Cents`), porcentajes en puntos base (`*Bps`, 10000 = 100%).
+ */
+/**
+ * Un par de valores: sin cuota y con cuota.
+ *
+ * ⚠️ **No es un descuento: son dos tablas de precios.** Alcanzar la cuota no «suma un bono», elige
+ * columna. Por eso `base: 0, withQuota: 2500` (PayJoy) es válido y significa «solo comisiona si
+ * alcanzó la cuota», no un error de captura.
+ */
+export interface CommissionValuePair {
+    /** Valor cuando NO se alcanzó la cuota. Puede ser 0. */
+    base: number;
+    /** Valor cuando SÍ se alcanzó. Puede ser igual al base si la categoría no discrimina. */
+    withQuota: number;
+}
+/** Un tramo de precio del equipo. Los tramos no se solapan y cubren de 0 a infinito. */
+export interface CommissionPriceTier extends CommissionValuePair {
+    /** Etiqueta visible: `D`, `C`, `B`, `A`. */
+    grade: string;
+    minCents: number;
+    /** `null` = sin tope superior (el tramo más alto). */
+    maxCents: number | null;
+}
+/** Una celda de la matriz, identificada por sus coordenadas. */
+export interface CommissionMatrixCell extends CommissionValuePair {
+    /** Un valor por dimensión, en el mismo orden que `dimensions`. */
+    coords: string[];
+}
+/** Una variante enumerada (un plan de pospago, por ejemplo). */
+export interface CommissionVariant extends CommissionValuePair {
+    variantId: string;
+    label: string;
+}
+/** Una variante por forma de pago. Los valores van en bps. */
+export interface CommissionPaymentVariant extends CommissionValuePair {
+    /** `CASH` | `CREDIT` — cómo pagó el cliente. */
+    paymentType: string;
+    label: string;
+}
+/**
+ * La mecánica de una categoría, discriminada por `type`.
+ *
+ * `PRICE_TIER`, `FLAT`, `MATRIX` y `VARIANT` pagan en CENTAVOS; `PERCENT` y `PERCENT_BY_PAYMENT`
+ * pagan en BPS sobre el precio. Esa distinción la resuelve el evaluador con `valueKind`, no una rama
+ * por tipo.
+ */
+export type CommissionMechanic = {
+    type: CommissionMechanicTypeEnum.PRICE_TIER;
+    tiers: CommissionPriceTier[];
+} | {
+    type: CommissionMechanicTypeEnum.FLAT;
+    value: CommissionValuePair;
+} | {
+    type: CommissionMechanicTypeEnum.PERCENT;
+    value: CommissionValuePair;
+} | {
+    type: CommissionMechanicTypeEnum.MATRIX;
+    dimensions: string[];
+    cells: CommissionMatrixCell[];
+} | {
+    type: CommissionMechanicTypeEnum.VARIANT;
+    variants: CommissionVariant[];
+} | {
+    type: CommissionMechanicTypeEnum.PERCENT_BY_PAYMENT;
+    variants: CommissionPaymentVariant[];
+};
+/** Un nivel del acelerador. `factorBps` 10000 = 1.0×, 12000 = 1.2×. */
+export interface CommissionQuotaLevel {
+    minAmountCents: number;
+    factorBps: number;
+}
+/**
+ * Una cuota. Binaria (un gate) o escalonada (N niveles con multiplicador).
+ *
+ * ⚠️ **Todas se resuelven al CERRAR el periodo**, nunca al devengar. Ese es el diseño de Jaime y es
+ * lo que evita el mecanismo más peligroso posible: reescribir filas ya devengadas cada vez que una
+ * venta nueva mueve el conteo.
+ */
+export interface CommissionQuota {
+    quotaId: string;
+    name: string;
+    description: string | null;
+    active: boolean;
+    type: CommissionQuotaTypeEnum;
+    measure: CommissionQuotaMeasureEnum;
+    subject: CommissionQuotaSubjectEnum;
+    period: CommissionPeriodTypeEnum;
+    mode: CommissionQuotaModeEnum;
+    /** Solo `BINARY`. El umbral a alcanzar, en la unidad de `measure`. */
+    threshold: number | null;
+    /** Solo `TIERED`. Ordenados de menor a mayor. */
+    levels: CommissionQuotaLevel[] | null;
+    /** Si el valor `withQuota` REEMPLAZA al base (`true`) o se suma. Hoy siempre `true`. */
+    replacesBase: boolean;
+}
+/**
+ * Cómo se decide que una venta pertenece a esta categoría.
+ *
+ * Vive DENTRO del snapshot (versionado e inmutable con el plan). Si viviera en el código del motor,
+ * cambiar el mapa reescribiría el pasado.
+ */
+export interface CommissionCategoryMatch {
+    skus: string[];
+    brands: string[];
+    /** Prefijos de SKU, para familias completas. */
+    skuPrefixes: string[];
+}
+/**
+ * Una excepción: un SKU o una marca que paga distinto que su categoría.
+ *
+ * Precedencia: **SKU gana sobre BRAND, y BRAND sobre la mecánica.**
+ */
+export interface CommissionException {
+    exceptionId: string;
+    type: CommissionExceptionTypeEnum;
+    /** El SKU exacto o el nombre de la marca, según `type`. */
+    target: string;
+    label: string;
+    value: CommissionValuePair;
+}
+/** Una categoría de producto con su mecánica, su cuota y sus excepciones. */
+export interface CommissionCategory {
+    categoryId: string;
+    name: string;
+    icon: string | null;
+    description: string | null;
+    match: CommissionCategoryMatch;
+    /** `null` = la categoría NO está condicionada a ninguna cuota (Pospago, Zmotos). */
+    quotaId: string | null;
+    priceReference: CommissionPriceReferenceEnum;
+    mechanic: CommissionMechanic;
+    exceptions: CommissionException[];
+}
+/** Un add-on: monto fijo que se suma FUERA del stacking y fuera del máximo. */
+export interface CommissionAddOn {
+    addOnId: string;
+    label: string;
+    amountCents: number;
+    active: boolean;
+}
+/**
+ * Una versión del plan. Publicada es inmutable; el borrador se pisa.
+ *
+ * `storeOverrideBps` es un **pago a OTRA persona** (el admin de la tienda) sobre las ventas de su
+ * equipo. Se modela pero **no se devenga** en el primer corte, hasta que se defina quién es ese
+ * admin en `retail-org-business`.
+ */
+export interface CommissionPlanSnapshot {
+    retailerId: string;
+    /** `null` mientras es borrador: el ULID se asigna al publicar. */
+    snapshotId: string | null;
+    status: CommissionPlanStatusEnum;
+    effectiveFrom: string;
+    categories: CommissionCategory[];
+    quotas: CommissionQuota[];
+    addOns: CommissionAddOn[];
+    /** `storeId` → bps adicionales para el admin de esa tienda. */
+    storeOverrideBps: Record<string, number>;
+    changeNote: string | null;
+    publishedBy: string | null;
+    publishedAt: string | null;
+    updatedAt: string | null;
+    updatedBy: string | null;
+}

package/bin/retailCommission/dtos/CommissionPlan.js

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

package/bin/retailCommission/enums/CommissionAccrualStatusEnum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Estado de una fila de devengo.
+ *
+ * ACCRUED - Devengada con su monto base. La cuota y el factor TODAVÍA no están resueltos.
+ * PAID - Liquidada al cerrar el corte: ya tiene `quotaMet`, `quotaFactorBps` y `settledAmountCents`.
+ * REVERSED - Revertida por cancelación de la venta, con el corte aún abierto.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export declare enum CommissionAccrualStatusEnum {
+    ACCRUED = "ACCRUED",
+    PAID = "PAID",
+    REVERSED = "REVERSED"
+}

package/bin/retailCommission/enums/CommissionAccrualStatusEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionAccrualStatusEnum = void 0;
+/**
+ * Estado de una fila de devengo.
+ *
+ * ACCRUED - Devengada con su monto base. La cuota y el factor TODAVÍA no están resueltos.
+ * PAID - Liquidada al cerrar el corte: ya tiene `quotaMet`, `quotaFactorBps` y `settledAmountCents`.
+ * REVERSED - Revertida por cancelación de la venta, con el corte aún abierto.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+var CommissionAccrualStatusEnum;
+(function (CommissionAccrualStatusEnum) {
+    CommissionAccrualStatusEnum["ACCRUED"] = "ACCRUED";
+    CommissionAccrualStatusEnum["PAID"] = "PAID";
+    CommissionAccrualStatusEnum["REVERSED"] = "REVERSED";
+})(CommissionAccrualStatusEnum || (exports.CommissionAccrualStatusEnum = CommissionAccrualStatusEnum = {}));

package/bin/retailCommission/enums/CommissionCalcStepEnum.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Los pasos que puede registrar la traza de cálculo.
+ *
+ * La traza es una unión CERRADA por este enum, sin campos libres: es el vehículo más probable de
+ * fuga de PII del comprador y no debe haber dónde meterla.
+ *
+ * MECHANIC - Se evaluó la mecánica de la categoría.
+ * EXCEPTION - Una excepción por SKU o marca reemplazó el valor de la mecánica.
+ * ADDON - Se sumó un add-on. Van FUERA del stacking.
+ * QUOTA - Se resolvió la cuota (binaria o escalonada). Ocurre al CERRAR, no al devengar.
+ * ADJUSTMENT - Un ajuste manual del corte.
+ * NO_CATEGORY - El SKU no matcheó ninguna categoría del plan: devenga 0 y queda visible.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export declare enum CommissionCalcStepEnum {
+    MECHANIC = "MECHANIC",
+    EXCEPTION = "EXCEPTION",
+    ADDON = "ADDON",
+    QUOTA = "QUOTA",
+    ADJUSTMENT = "ADJUSTMENT",
+    NO_CATEGORY = "NO_CATEGORY"
+}

package/bin/retailCommission/enums/CommissionCalcStepEnum.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionCalcStepEnum = void 0;
+/**
+ * Los pasos que puede registrar la traza de cálculo.
+ *
+ * La traza es una unión CERRADA por este enum, sin campos libres: es el vehículo más probable de
+ * fuga de PII del comprador y no debe haber dónde meterla.
+ *
+ * MECHANIC - Se evaluó la mecánica de la categoría.
+ * EXCEPTION - Una excepción por SKU o marca reemplazó el valor de la mecánica.
+ * ADDON - Se sumó un add-on. Van FUERA del stacking.
+ * QUOTA - Se resolvió la cuota (binaria o escalonada). Ocurre al CERRAR, no al devengar.
+ * ADJUSTMENT - Un ajuste manual del corte.
+ * NO_CATEGORY - El SKU no matcheó ninguna categoría del plan: devenga 0 y queda visible.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+var CommissionCalcStepEnum;
+(function (CommissionCalcStepEnum) {
+    CommissionCalcStepEnum["MECHANIC"] = "MECHANIC";
+    CommissionCalcStepEnum["EXCEPTION"] = "EXCEPTION";
+    CommissionCalcStepEnum["ADDON"] = "ADDON";
+    CommissionCalcStepEnum["QUOTA"] = "QUOTA";
+    CommissionCalcStepEnum["ADJUSTMENT"] = "ADJUSTMENT";
+    CommissionCalcStepEnum["NO_CATEGORY"] = "NO_CATEGORY";
+})(CommissionCalcStepEnum || (exports.CommissionCalcStepEnum = CommissionCalcStepEnum = {}));

package/bin/retailCommission/enums/CommissionExceptionTypeEnum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Sobre qué aplica una excepción del plan.
+ *
+ * Precedencia: SKU gana sobre BRAND, y BRAND sobre la mecánica de la categoría.
+ *
+ * SKU - Un SKU exacto.
+ * BRAND - Una marca completa.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export declare enum CommissionExceptionTypeEnum {
+    SKU = "SKU",
+    BRAND = "BRAND"
+}

package/bin/retailCommission/enums/CommissionExceptionTypeEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionExceptionTypeEnum = void 0;
+/**
+ * Sobre qué aplica una excepción del plan.
+ *
+ * Precedencia: SKU gana sobre BRAND, y BRAND sobre la mecánica de la categoría.
+ *
+ * SKU - Un SKU exacto.
+ * BRAND - Una marca completa.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+var CommissionExceptionTypeEnum;
+(function (CommissionExceptionTypeEnum) {
+    CommissionExceptionTypeEnum["SKU"] = "SKU";
+    CommissionExceptionTypeEnum["BRAND"] = "BRAND";
+})(CommissionExceptionTypeEnum || (exports.CommissionExceptionTypeEnum = CommissionExceptionTypeEnum = {}));

package/bin/retailCommission/enums/CommissionMechanicTypeEnum.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Las 6 formas de calcular la comisión de una categoría (D12).
+ *
+ * Son el producto cartesiano de dos ejes —cómo se elige la celda y en qué unidad paga— y por eso
+ * un solo evaluador las cubre todas: `toCells(mechanic)` normaliza cualquiera a
+ * `[{ match, baseValue, withQuotaValue }]` + `valueKind`.
+ *
+ * PRICE_TIER - Por rango de precio del equipo (D/C/B/A). Equipos.
+ * FLAT - Monto fijo por unidad. MiFi, PayJoy.
+ * PERCENT - Porcentaje del precio, en bps. Accesorios.
+ * MATRIX - Celda por N dimensiones. SIMs: operador × origen.
+ * VARIANT - Monto por variante enumerada. Pospago: plan $339 → $220.
+ * PERCENT_BY_PAYMENT - Porcentaje según forma de pago. Zmotos: contado 2% / crédito 4%.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export declare enum CommissionMechanicTypeEnum {
+    PRICE_TIER = "PRICE_TIER",
+    FLAT = "FLAT",
+    PERCENT = "PERCENT",
+    MATRIX = "MATRIX",
+    VARIANT = "VARIANT",
+    PERCENT_BY_PAYMENT = "PERCENT_BY_PAYMENT"
+}

package/bin/retailCommission/enums/CommissionMechanicTypeEnum.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionMechanicTypeEnum = void 0;
+/**
+ * Las 6 formas de calcular la comisión de una categoría (D12).
+ *
+ * Son el producto cartesiano de dos ejes —cómo se elige la celda y en qué unidad paga— y por eso
+ * un solo evaluador las cubre todas: `toCells(mechanic)` normaliza cualquiera a
+ * `[{ match, baseValue, withQuotaValue }]` + `valueKind`.
+ *
+ * PRICE_TIER - Por rango de precio del equipo (D/C/B/A). Equipos.
+ * FLAT - Monto fijo por unidad. MiFi, PayJoy.
+ * PERCENT - Porcentaje del precio, en bps. Accesorios.
+ * MATRIX - Celda por N dimensiones. SIMs: operador × origen.
+ * VARIANT - Monto por variante enumerada. Pospago: plan $339 → $220.
+ * PERCENT_BY_PAYMENT - Porcentaje según forma de pago. Zmotos: contado 2% / crédito 4%.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+var CommissionMechanicTypeEnum;
+(function (CommissionMechanicTypeEnum) {
+    CommissionMechanicTypeEnum["PRICE_TIER"] = "PRICE_TIER";
+    CommissionMechanicTypeEnum["FLAT"] = "FLAT";
+    CommissionMechanicTypeEnum["PERCENT"] = "PERCENT";
+    CommissionMechanicTypeEnum["MATRIX"] = "MATRIX";
+    CommissionMechanicTypeEnum["VARIANT"] = "VARIANT";
+    CommissionMechanicTypeEnum["PERCENT_BY_PAYMENT"] = "PERCENT_BY_PAYMENT";
+})(CommissionMechanicTypeEnum || (exports.CommissionMechanicTypeEnum = CommissionMechanicTypeEnum = {}));

package/bin/retailCommission/enums/CommissionPayeeTypeEnum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Quién cobra una fila de devengo.
+ *
+ * SELLER - El vendedor que originó la venta. Único que se devenga en el primer corte.
+ * STORE_ADMIN - El admin de la tienda, por el `storeOverrideBps`. ⚠️ Modelado pero NO devengado
+ *   hasta que se defina quién es ese admin en `retail-org-business`.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export declare enum CommissionPayeeTypeEnum {
+    SELLER = "SELLER",
+    STORE_ADMIN = "STORE_ADMIN"
+}

package/bin/retailCommission/enums/CommissionPayeeTypeEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionPayeeTypeEnum = void 0;
+/**
+ * Quién cobra una fila de devengo.
+ *
+ * SELLER - El vendedor que originó la venta. Único que se devenga en el primer corte.
+ * STORE_ADMIN - El admin de la tienda, por el `storeOverrideBps`. ⚠️ Modelado pero NO devengado
+ *   hasta que se defina quién es ese admin en `retail-org-business`.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+var CommissionPayeeTypeEnum;
+(function (CommissionPayeeTypeEnum) {
+    CommissionPayeeTypeEnum["SELLER"] = "SELLER";
+    CommissionPayeeTypeEnum["STORE_ADMIN"] = "STORE_ADMIN";
+})(CommissionPayeeTypeEnum || (exports.CommissionPayeeTypeEnum = CommissionPayeeTypeEnum = {}));

package/bin/retailCommission/enums/CommissionPayoutStatusEnum.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Estado del corte semanal.
+ *
+ * OPEN - Acumulando devengos. Nadie lo «abre»: el ítem META se crea con upsert al primer ajuste o al cerrar.
+ * CLOSING - Cierre encolado o corriendo. Es el candado: sin este estado, dos clicks en «Cerrar»
+ *   encolan dos workers que liquidan en paralelo, y la UI no puede distinguir «abierto» de «cerrando».
+ * CLOSED - Terminado. Es la ÚLTIMA escritura del worker, no la primera: significa «se pagó todo»,
+ *   no «se empezó a pagar».
+ *
+ * ⚠️ No existe `PAID`: **Fiado no dispersa el pago**. El archivo se entrega a la nómina de LUGA.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export declare enum CommissionPayoutStatusEnum {
+    OPEN = "OPEN",
+    CLOSING = "CLOSING",
+    CLOSED = "CLOSED"
+}

package/bin/retailCommission/enums/CommissionPayoutStatusEnum.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionPayoutStatusEnum = void 0;
+/**
+ * Estado del corte semanal.
+ *
+ * OPEN - Acumulando devengos. Nadie lo «abre»: el ítem META se crea con upsert al primer ajuste o al cerrar.
+ * CLOSING - Cierre encolado o corriendo. Es el candado: sin este estado, dos clicks en «Cerrar»
+ *   encolan dos workers que liquidan en paralelo, y la UI no puede distinguir «abierto» de «cerrando».
+ * CLOSED - Terminado. Es la ÚLTIMA escritura del worker, no la primera: significa «se pagó todo»,
+ *   no «se empezó a pagar».
+ *
+ * ⚠️ No existe `PAID`: **Fiado no dispersa el pago**. El archivo se entrega a la nómina de LUGA.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+var CommissionPayoutStatusEnum;
+(function (CommissionPayoutStatusEnum) {
+    CommissionPayoutStatusEnum["OPEN"] = "OPEN";
+    CommissionPayoutStatusEnum["CLOSING"] = "CLOSING";
+    CommissionPayoutStatusEnum["CLOSED"] = "CLOSED";
+})(CommissionPayoutStatusEnum || (exports.CommissionPayoutStatusEnum = CommissionPayoutStatusEnum = {}));

package/bin/retailCommission/enums/CommissionPeriodTypeEnum.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Periodicidad de la cuota. El modal del plan ofrece las tres.
+ *
+ * ⚠️ El primer corte implementa SOLO `WEEKLY`; las otras dos se rechazan con error tipado en vez de
+ * calcularse mal en silencio.
+ *
+ * WEEKLY - Semanal. `M6_ADMIN` §9.3 y §9.4: corte de martes a lunes.
+ * BIWEEKLY - Quincenal. No implementada.
+ * MONTHLY - Mensual. No implementada.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export declare enum CommissionPeriodTypeEnum {
+    WEEKLY = "WEEKLY",
+    BIWEEKLY = "BIWEEKLY",
+    MONTHLY = "MONTHLY"
+}

package/bin/retailCommission/enums/CommissionPeriodTypeEnum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionPeriodTypeEnum = void 0;
+/**
+ * Periodicidad de la cuota. El modal del plan ofrece las tres.
+ *
+ * ⚠️ El primer corte implementa SOLO `WEEKLY`; las otras dos se rechazan con error tipado en vez de
+ * calcularse mal en silencio.
+ *
+ * WEEKLY - Semanal. `M6_ADMIN` §9.3 y §9.4: corte de martes a lunes.
+ * BIWEEKLY - Quincenal. No implementada.
+ * MONTHLY - Mensual. No implementada.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+var CommissionPeriodTypeEnum;
+(function (CommissionPeriodTypeEnum) {
+    CommissionPeriodTypeEnum["WEEKLY"] = "WEEKLY";
+    CommissionPeriodTypeEnum["BIWEEKLY"] = "BIWEEKLY";
+    CommissionPeriodTypeEnum["MONTHLY"] = "MONTHLY";
+})(CommissionPeriodTypeEnum || (exports.CommissionPeriodTypeEnum = CommissionPeriodTypeEnum = {}));

package/bin/retailCommission/enums/CommissionPlanStatusEnum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Estado de una versión del plan de comisiones.
+ *
+ * DRAFT - Borrador en edición. Ítem ÚNICO (`sk = DRAFT`): se pisa, no versiona.
+ * PUBLISHED - Snapshot sellado y vigente. Apuntado por el puntero `ACTIVE`.
+ * SUPERSEDED - Snapshot que fue vigente y ya no lo es. Inmutable: lo devengado con él ya se devengó.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export declare enum CommissionPlanStatusEnum {
+    DRAFT = "DRAFT",
+    PUBLISHED = "PUBLISHED",
+    SUPERSEDED = "SUPERSEDED"
+}

package/bin/retailCommission/enums/CommissionPlanStatusEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionPlanStatusEnum = void 0;
+/**
+ * Estado de una versión del plan de comisiones.
+ *
+ * DRAFT - Borrador en edición. Ítem ÚNICO (`sk = DRAFT`): se pisa, no versiona.
+ * PUBLISHED - Snapshot sellado y vigente. Apuntado por el puntero `ACTIVE`.
+ * SUPERSEDED - Snapshot que fue vigente y ya no lo es. Inmutable: lo devengado con él ya se devengó.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+var CommissionPlanStatusEnum;
+(function (CommissionPlanStatusEnum) {
+    CommissionPlanStatusEnum["DRAFT"] = "DRAFT";
+    CommissionPlanStatusEnum["PUBLISHED"] = "PUBLISHED";
+    CommissionPlanStatusEnum["SUPERSEDED"] = "SUPERSEDED";
+})(CommissionPlanStatusEnum || (exports.CommissionPlanStatusEnum = CommissionPlanStatusEnum = {}));

package/bin/retailCommission/enums/CommissionPriceReferenceEnum.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Contra qué precio se evalúa la mecánica de una categoría.
+ *
+ * ⚠️ En el primer corte las tres resuelven contra el mismo número: la venta trae UN precio
+ * (`equipmentPriceCents`, con `amountCents` de respaldo). Se modela porque el plan de Jaime lo
+ * declara por categoría y borrarlo obligaría a migrar los snapshots cuando lleguen los tres precios.
+ *
+ * LIST - Precio de lista.
+ * FINAL - Precio final cobrado.
+ * PUBLIC - Precio público sugerido.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export declare enum CommissionPriceReferenceEnum {
+    LIST = "LIST",
+    FINAL = "FINAL",
+    PUBLIC = "PUBLIC"
+}

package/bin/retailCommission/enums/CommissionPriceReferenceEnum.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionPriceReferenceEnum = void 0;
+/**
+ * Contra qué precio se evalúa la mecánica de una categoría.
+ *
+ * ⚠️ En el primer corte las tres resuelven contra el mismo número: la venta trae UN precio
+ * (`equipmentPriceCents`, con `amountCents` de respaldo). Se modela porque el plan de Jaime lo
+ * declara por categoría y borrarlo obligaría a migrar los snapshots cuando lleguen los tres precios.
+ *
+ * LIST - Precio de lista.
+ * FINAL - Precio final cobrado.
+ * PUBLIC - Precio público sugerido.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+var CommissionPriceReferenceEnum;
+(function (CommissionPriceReferenceEnum) {
+    CommissionPriceReferenceEnum["LIST"] = "LIST";
+    CommissionPriceReferenceEnum["FINAL"] = "FINAL";
+    CommissionPriceReferenceEnum["PUBLIC"] = "PUBLIC";
+})(CommissionPriceReferenceEnum || (exports.CommissionPriceReferenceEnum = CommissionPriceReferenceEnum = {}));

package/bin/retailCommission/enums/CommissionQuotaMeasureEnum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Qué se mide para evaluar la cuota.
+ *
+ * UNITS - Piezas vendidas en el periodo.
+ * SK_AMOUNT - Monto vendido, contando SOLO las ventas con financiera SUREKEEP.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export declare enum CommissionQuotaMeasureEnum {
+    UNITS = "UNITS",
+    SK_AMOUNT = "SK_AMOUNT"
+}

package/bin/retailCommission/enums/CommissionQuotaMeasureEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionQuotaMeasureEnum = void 0;
+/**
+ * Qué se mide para evaluar la cuota.
+ *
+ * UNITS - Piezas vendidas en el periodo.
+ * SK_AMOUNT - Monto vendido, contando SOLO las ventas con financiera SUREKEEP.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+var CommissionQuotaMeasureEnum;
+(function (CommissionQuotaMeasureEnum) {
+    CommissionQuotaMeasureEnum["UNITS"] = "UNITS";
+    CommissionQuotaMeasureEnum["SK_AMOUNT"] = "SK_AMOUNT";
+})(CommissionQuotaMeasureEnum || (exports.CommissionQuotaMeasureEnum = CommissionQuotaMeasureEnum = {}));

package/bin/retailCommission/enums/CommissionQuotaModeEnum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Cómo se aplica la cuota al alcanzarse.
+ *
+ * Queda con un solo valor A PROPÓSITO: es un campo enumerable del dominio, no un flag. Guardarlo
+ * como booleano obligaría a migrar los snapshots el día que aparezca un modo prospectivo.
+ *
+ * RETROACTIVE - Aplica a TODO lo devengado en el periodo, no solo a lo que vino después.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export declare enum CommissionQuotaModeEnum {
+    RETROACTIVE = "RETROACTIVE"
+}

package/bin/retailCommission/enums/CommissionQuotaModeEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionQuotaModeEnum = void 0;
+/**
+ * Cómo se aplica la cuota al alcanzarse.
+ *
+ * Queda con un solo valor A PROPÓSITO: es un campo enumerable del dominio, no un flag. Guardarlo
+ * como booleano obligaría a migrar los snapshots el día que aparezca un modo prospectivo.
+ *
+ * RETROACTIVE - Aplica a TODO lo devengado en el periodo, no solo a lo que vino después.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+var CommissionQuotaModeEnum;
+(function (CommissionQuotaModeEnum) {
+    CommissionQuotaModeEnum["RETROACTIVE"] = "RETROACTIVE";
+})(CommissionQuotaModeEnum || (exports.CommissionQuotaModeEnum = CommissionQuotaModeEnum = {}));

package/bin/retailCommission/enums/CommissionQuotaSubjectEnum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Sobre quién se acumula la cuota.
+ *
+ * SELLER - Por vendedor. Único implementado en el primer corte.
+ * STORE - Por tienda: la alcanza el equipo completo.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+export declare enum CommissionQuotaSubjectEnum {
+    SELLER = "SELLER",
+    STORE = "STORE"
+}

package/bin/retailCommission/enums/CommissionQuotaSubjectEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionQuotaSubjectEnum = void 0;
+/**
+ * Sobre quién se acumula la cuota.
+ *
+ * SELLER - Por vendedor. Único implementado en el primer corte.
+ * STORE - Por tienda: la alcanza el equipo completo.
+ *
+ * SureKeep Fase 3 — pista Retail. Motor de comisiones de VentasLuga.
+ */
+var CommissionQuotaSubjectEnum;
+(function (CommissionQuotaSubjectEnum) {
+    CommissionQuotaSubjectEnum["SELLER"] = "SELLER";
+    CommissionQuotaSubjectEnum["STORE"] = "STORE";
+})(CommissionQuotaSubjectEnum || (exports.CommissionQuotaSubjectEnum = CommissionQuotaSubjectEnum = {}));