@fiado/type-kit 3.193.0 → 3.195.0

package/bin/retailCustomer/dtos/requests/UpsertCustomerFromKycRequest.js

@@ -0,0 +1,97 @@
+"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.UpsertCustomerFromKycRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const regex_1 = require("../../../helpers/constans/regex");
+const AddressBase_1 = require("../../../address/dtos/AddressBase");
+const KycModalityEnum_1 = require("../../enums/KycModalityEnum");
+const RetailKycStatusEnum_1 = require("../../enums/RetailKycStatusEnum");
+/**
+ * Upsert idempotente del cliente tras el KYC (paso 02f). UNIQ#PHONE + UNIQ#CURP en la misma TX.
+ * El endpoint setea `accountStatus=OPENING` server-side (la apertura corre en background, D35).
+ * SureKeep Fase 2 — pista Retail.
+ */
+class UpsertCustomerFromKycRequest {
+}
+exports.UpsertCustomerFromKycRequest = UpsertCustomerFromKycRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.replace(/[\s-]/g, '') : value)),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(regex_1.regexPhoneMx, { message: 'phone debe ser 10 dígitos MX' }),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "phone", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.toUpperCase() : value)),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(regex_1.regexCurp, { message: 'curp con formato inválido' }),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "curp", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(regex_1.regexIso8601Date, { message: 'birthDate debe ser una fecha ISO 8601' }),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "birthDate", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "fiadoDirectoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "fiadoPeopleId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "pcfAccountId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "pcfClabe", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)([1, 2]),
+    __metadata("design:type", Number)
+], UpsertCustomerFromKycRequest.prototype, "pcfAccountLevel", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(RetailKycStatusEnum_1.RetailKycStatusEnum),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "kycStatus", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(KycModalityEnum_1.KycModalityEnum),
+    __metadata("design:type", String)
+], UpsertCustomerFromKycRequest.prototype, "kycModality", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => AddressBase_1.AddressBase),
+    __metadata("design:type", AddressBase_1.AddressBase)
+], UpsertCustomerFromKycRequest.prototype, "address", void 0);

package/bin/retailCustomer/dtos/responses/Customer360Response.d.ts

@@ -0,0 +1,33 @@
+import { CustomerResponse } from './CustomerResponse';
+/** Resumen de wallet (nivel N1/N2 + saldo) para el Cliente 360. */
+export interface Customer360Wallet {
+    accountLevel: 1 | 2 | null;
+    clabe: string | null;
+    balanceCents: number;
+}
+/** Ítem de compra en el historial del Cliente 360 (del GSI customerId-soldAt). */
+export interface Customer360Purchase {
+    saleId: string;
+    sku: string;
+    amountCents: number;
+    folio: string;
+    soldAt: string;
+    status: string;
+}
+/** Ítem de prospecto vinculado al cliente en el Cliente 360. */
+export interface Customer360Prospect {
+    prospectId: string;
+    pendingReason: string;
+    status: string;
+    nextContactAt: string;
+}
+/**
+ * Ficha Cliente 360 (BO): compone KYC + wallet N1/N2 + compras + prospectos. Cada bloque se hidrata
+ * desde su owner (customer, transaction-processor, sale GSI, prospect GSI). SureKeep Fase 2 — pista Retail.
+ */
+export interface Customer360Response {
+    customer: CustomerResponse;
+    wallet: Customer360Wallet;
+    purchases: Customer360Purchase[];
+    prospects: Customer360Prospect[];
+}

package/bin/retailCustomer/dtos/responses/Customer360Response.js

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

package/bin/retailCustomer/dtos/responses/CustomerResponse.d.ts

@@ -0,0 +1,30 @@
+import { AddressBase } from '../../../address/dtos/AddressBase';
+import { AccountStatusEnum } from '../../enums/AccountStatusEnum';
+import { KycModalityEnum } from '../../enums/KycModalityEnum';
+import { RetailKycStatusEnum } from '../../enums/RetailKycStatusEnum';
+/**
+ * Vista de un cliente retail hacia el consumidor (BO / api-invoker). SureKeep Fase 2 — pista Retail.
+ * `address` reusa el `AddressBase` canónico de Fiado (ver TD en RetailCustomer.address).
+ */
+export interface CustomerResponse {
+    retailCustomerId: string;
+    retailerId: string;
+    name: string;
+    phone: string;
+    curp: string;
+    birthDate: string | null;
+    fiadoDirectoryId: string | null;
+    fiadoPeopleId: string | null;
+    pcfAccountId: string | null;
+    pcfClabe: string | null;
+    pcfAccountLevel: 1 | 2 | null;
+    accountStatus: AccountStatusEnum | null;
+    failReason: string | null;
+    welcomeAccredited: boolean;
+    address: AddressBase | null;
+    addressConfirmed: boolean;
+    kycStatus: RetailKycStatusEnum;
+    kycModality: KycModalityEnum | null;
+    createdAt: string;
+    updatedAt: string;
+}

package/bin/retailCustomer/dtos/responses/CustomerResponse.js

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

package/bin/retailCustomer/enums/AccountStatusEnum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Estado de la apertura async de la cuenta PagoConFiado (PCF) del cliente retail (D35).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export declare enum AccountStatusEnum {
+    OPENING = "OPENING",
+    OPEN = "OPEN",
+    FAILED = "FAILED"
+}

package/bin/retailCustomer/enums/AccountStatusEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountStatusEnum = void 0;
+/**
+ * Estado de la apertura async de la cuenta PagoConFiado (PCF) del cliente retail (D35).
+ * SureKeep Fase 2 — pista Retail.
+ */
+var AccountStatusEnum;
+(function (AccountStatusEnum) {
+    AccountStatusEnum["OPENING"] = "OPENING";
+    AccountStatusEnum["OPEN"] = "OPEN";
+    AccountStatusEnum["FAILED"] = "FAILED";
+})(AccountStatusEnum || (exports.AccountStatusEnum = AccountStatusEnum = {}));

package/bin/retailCustomer/enums/KycModalityEnum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Modalidad con la que el cliente ejecuta el KYC en el wizard (M1 §213-329).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export declare enum KycModalityEnum {
+    CUSTOMER_LINK = "CUSTOMER_LINK",
+    STORE_DEVICE = "STORE_DEVICE",
+    MANUAL = "MANUAL"
+}

package/bin/retailCustomer/enums/KycModalityEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KycModalityEnum = void 0;
+/**
+ * Modalidad con la que el cliente ejecuta el KYC en el wizard (M1 §213-329).
+ * SureKeep Fase 2 — pista Retail.
+ */
+var KycModalityEnum;
+(function (KycModalityEnum) {
+    KycModalityEnum["CUSTOMER_LINK"] = "CUSTOMER_LINK";
+    KycModalityEnum["STORE_DEVICE"] = "STORE_DEVICE";
+    KycModalityEnum["MANUAL"] = "MANUAL";
+})(KycModalityEnum || (exports.KycModalityEnum = KycModalityEnum = {}));

package/bin/retailCustomer/enums/KycReviewResultEnum.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resultado de la revisión manual del oficial de Cumplimiento (D21).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export declare enum KycReviewResultEnum {
+    APPROVED = "APPROVED",
+    REJECTED = "REJECTED"
+}

package/bin/retailCustomer/enums/KycReviewResultEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KycReviewResultEnum = void 0;
+/**
+ * Resultado de la revisión manual del oficial de Cumplimiento (D21).
+ * SureKeep Fase 2 — pista Retail.
+ */
+var KycReviewResultEnum;
+(function (KycReviewResultEnum) {
+    KycReviewResultEnum["APPROVED"] = "APPROVED";
+    KycReviewResultEnum["REJECTED"] = "REJECTED";
+})(KycReviewResultEnum || (exports.KycReviewResultEnum = KycReviewResultEnum = {}));

package/bin/retailCustomer/enums/RetailKycStatusEnum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Estado del KYC del cliente retail (vocabulario retail; espejo operativo del KYC de Fiado).
+ * PENDING (sin resultado) · VERIFIED (Metamap OK) · FAILED (incluye PLD) · MANUAL (captura manual,
+ * cae en cola de Cumplimiento) · REVIEW (esperando resolución de Cumplimiento).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export declare enum RetailKycStatusEnum {
+    PENDING = "PENDING",
+    VERIFIED = "VERIFIED",
+    FAILED = "FAILED",
+    MANUAL = "MANUAL",
+    REVIEW = "REVIEW"
+}

package/bin/retailCustomer/enums/RetailKycStatusEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailKycStatusEnum = void 0;
+/**
+ * Estado del KYC del cliente retail (vocabulario retail; espejo operativo del KYC de Fiado).
+ * PENDING (sin resultado) · VERIFIED (Metamap OK) · FAILED (incluye PLD) · MANUAL (captura manual,
+ * cae en cola de Cumplimiento) · REVIEW (esperando resolución de Cumplimiento).
+ * SureKeep Fase 2 — pista Retail.
+ */
+var RetailKycStatusEnum;
+(function (RetailKycStatusEnum) {
+    RetailKycStatusEnum["PENDING"] = "PENDING";
+    RetailKycStatusEnum["VERIFIED"] = "VERIFIED";
+    RetailKycStatusEnum["FAILED"] = "FAILED";
+    RetailKycStatusEnum["MANUAL"] = "MANUAL";
+    RetailKycStatusEnum["REVIEW"] = "REVIEW";
+})(RetailKycStatusEnum || (exports.RetailKycStatusEnum = RetailKycStatusEnum = {}));

package/bin/retailCustomer/events/CustomerCreatedV1.d.ts

@@ -0,0 +1,7 @@
+/** Emitido cuando se da de alta un cliente retail (→ cola Central). SureKeep Fase 2 — pista Retail. */
+export interface CustomerCreatedV1 {
+    retailCustomerId: string;
+    retailerId: string;
+    phone: string;
+    occurredAt: string;
+}

package/bin/retailCustomer/events/CustomerCreatedV1.js

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

package/bin/retailCustomer/events/CustomerKycVerifiedV1.d.ts

@@ -0,0 +1,27 @@
+import { KycModalityEnum } from '../enums/KycModalityEnum';
+import { RetailKycStatusEnum } from '../enums/RetailKycStatusEnum';
+/**
+ * Puente retail↔sofom (D24/D35) — emitido en la MISMA TX del `upsert-from-kyc` con el payload OCR
+ * completo. Lo consume `loan-credit-business` (idempotente, hidrata `LoanBorrower_GT`) y dispara la
+ * apertura de cuenta async. También alimenta CDC→Iceberg (atomicidad efectiva por outbox).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface CustomerKycVerifiedV1 {
+    retailCustomerId: string;
+    retailerId: string;
+    fiadoDirectoryId: string;
+    fiadoPeopleId: string;
+    phone: string;
+    curp: string;
+    firstName: string;
+    paternalLastName: string;
+    maternalLastName: string | null;
+    birthDate: string;
+    sex: string | null;
+    nationality: string | null;
+    documentValidUntil: string | null;
+    addressRaw: string | null;
+    kycStatus: RetailKycStatusEnum;
+    kycModality: KycModalityEnum;
+    occurredAt: string;
+}

package/bin/retailCustomer/events/CustomerKycVerifiedV1.js

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

package/bin/retailCustomer/events/CustomerUpdatedV1.d.ts

@@ -0,0 +1,9 @@
+/** Emitido cuando se editan datos de contacto/PII de un cliente retail. SureKeep Fase 2 — pista Retail. */
+export interface CustomerUpdatedV1 {
+    retailCustomerId: string;
+    retailerId: string;
+    /** Nombres de los campos modificados (sin sus valores — PII zero-tolerance). */
+    updatedFields: string[];
+    updatedBy: string;
+    occurredAt: string;
+}

package/bin/retailCustomer/events/CustomerUpdatedV1.js

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

package/bin/retailCustomer/events/KycApprovedByComplianceV1.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Emitido cuando el oficial de Cumplimiento APRUEBA un KYC en revisión manual (D21). Dispara post-pasos
+ * idempotentes fuera de la TX (espejo a Fiado + apertura PCF N1 diferida). SureKeep Fase 2 — pista Retail.
+ */
+export interface KycApprovedByComplianceV1 {
+    retailCustomerId: string;
+    retailerId: string;
+    reviewedBy: string;
+    justification: string;
+    metamapVerificationId: string;
+    occurredAt: string;
+}

package/bin/retailCustomer/events/KycApprovedByComplianceV1.js

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

package/bin/retailCustomer/events/KycRejectedByComplianceV1.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Emitido cuando el oficial de Cumplimiento RECHAZA un KYC en revisión manual (D21).
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface KycRejectedByComplianceV1 {
+    retailCustomerId: string;
+    retailerId: string;
+    reviewedBy: string;
+    justification: string;
+    metamapVerificationId: string;
+    occurredAt: string;
+}

package/bin/retailCustomer/events/KycRejectedByComplianceV1.js

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

package/bin/retailCustomer/index.d.ts

@@ -0,0 +1,18 @@
+export * from './enums/AccountStatusEnum';
+export * from './enums/RetailKycStatusEnum';
+export * from './enums/KycModalityEnum';
+export * from './enums/KycReviewResultEnum';
+export * from './dtos/KycReview';
+export * from './dtos/RetailCustomer';
+export * from './dtos/requests/CreateCustomerRequest';
+export * from './dtos/requests/UpsertCustomerFromKycRequest';
+export * from './dtos/requests/UpdateCustomerRequest';
+export * from './dtos/requests/AccountResultRequest';
+export * from './dtos/requests/KycReviewRequest';
+export * from './dtos/responses/CustomerResponse';
+export * from './dtos/responses/Customer360Response';
+export * from './events/CustomerCreatedV1';
+export * from './events/CustomerUpdatedV1';
+export * from './events/CustomerKycVerifiedV1';
+export * from './events/KycApprovedByComplianceV1';
+export * from './events/KycRejectedByComplianceV1';

package/bin/retailCustomer/index.js

@@ -0,0 +1,39 @@
+"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/AccountStatusEnum"), exports);
+__exportStar(require("./enums/RetailKycStatusEnum"), exports);
+__exportStar(require("./enums/KycModalityEnum"), exports);
+__exportStar(require("./enums/KycReviewResultEnum"), exports);
+// Entidades (planas, con class-validator + @Expose)
+__exportStar(require("./dtos/KycReview"), exports);
+__exportStar(require("./dtos/RetailCustomer"), exports);
+// Request DTOs (input validado por endpoint)
+__exportStar(require("./dtos/requests/CreateCustomerRequest"), exports);
+__exportStar(require("./dtos/requests/UpsertCustomerFromKycRequest"), exports);
+__exportStar(require("./dtos/requests/UpdateCustomerRequest"), exports);
+__exportStar(require("./dtos/requests/AccountResultRequest"), exports);
+__exportStar(require("./dtos/requests/KycReviewRequest"), exports);
+// Response DTOs
+__exportStar(require("./dtos/responses/CustomerResponse"), exports);
+__exportStar(require("./dtos/responses/Customer360Response"), exports);
+// Contratos de eventos (PascalCase + sufijo V1)
+__exportStar(require("./events/CustomerCreatedV1"), exports);
+__exportStar(require("./events/CustomerUpdatedV1"), exports);
+__exportStar(require("./events/CustomerKycVerifiedV1"), exports);
+__exportStar(require("./events/KycApprovedByComplianceV1"), exports);
+__exportStar(require("./events/KycRejectedByComplianceV1"), exports);

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

@@ -0,0 +1,38 @@
+import { CollectorSeniorityEnum } from '../../enums/CollectorSeniorityEnum';
+import { EmploymentTypeEnum } from '../../enums/EmploymentTypeEnum';
+import { PermissionScope } from '../../../platformRbac/enums/PermissionScope';
+/**
+ * Body de POST /retailers/:retailerId/users/provision — alta de usuario retail ORQUESTADA (SureKeep F1,
+ * scope mirror). Invierte el orden del alta clásica: en vez de recibir un `cognitoSub` ya existente,
+ * retail-org provisiona al usuario en RBAC (Cognito + SharedUser + RoleAssignment) y luego crea el
+ * `RetailUser` con el `cognitoSub` retornado. El `retailerId` sale del path.
+ *
+ * Diferencia con {@link CreateRetailUserRequest}: aquí van `email` + `roleId` + `scope` + `scopeRef`
+ * (el grant de RBAC) en lugar de `cognitoSub`. El resto de los atributos comerciales son idénticos.
+ */
+export declare class ProvisionRetailUserRequest {
+    /** Identidad de login del usuario a provisionar en Cognito/RBAC. */
+    email: string;
+    /** Rol de RBAC a asignar (id del rol del tenant). */
+    roleId: string;
+    /** Scope del grant (ej. LEVEL_1 = retailer, LEVEL_3 = tienda). */
+    scope: PermissionScope;
+    /** Referencia del scope (ej. retailerId para LEVEL_1, storeId para LEVEL_3). */
+    scopeRef: string;
+    /**
+     * Nombre de display — etiqueta de conveniencia (DEC-SKF1-021). La identidad real vive en RBAC
+     * (DEC-SKF1-005); esto es solo un rótulo para reconocer al usuario en el backoffice. Opcional.
+     */
+    displayName?: string;
+    homeStoreId: string;
+    employmentType: EmploymentTypeEnum;
+    commissionTier: string;
+    /** Zona de operación del usuario; `null` si no está acotado a una zona. */
+    zoneId: string | null;
+    /** Teléfono de contacto del usuario retail; opcional. */
+    phone?: string;
+    /** Seniority del cobrador; solo aplica a usuarios retail con rol de cobrador. */
+    collectorSeniority?: CollectorSeniorityEnum;
+    /** Tiendas que cubre el cobrador (zona de cobranza); opcional. */
+    coverageStoreIds?: string[];
+}

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

@@ -0,0 +1,95 @@
+"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.ProvisionRetailUserRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const CollectorSeniorityEnum_1 = require("../../enums/CollectorSeniorityEnum");
+const EmploymentTypeEnum_1 = require("../../enums/EmploymentTypeEnum");
+const PermissionScope_1 = require("../../../platformRbac/enums/PermissionScope");
+/**
+ * Body de POST /retailers/:retailerId/users/provision — alta de usuario retail ORQUESTADA (SureKeep F1,
+ * scope mirror). Invierte el orden del alta clásica: en vez de recibir un `cognitoSub` ya existente,
+ * retail-org provisiona al usuario en RBAC (Cognito + SharedUser + RoleAssignment) y luego crea el
+ * `RetailUser` con el `cognitoSub` retornado. El `retailerId` sale del path.
+ *
+ * Diferencia con {@link CreateRetailUserRequest}: aquí van `email` + `roleId` + `scope` + `scopeRef`
+ * (el grant de RBAC) en lugar de `cognitoSub`. El resto de los atributos comerciales son idénticos.
+ */
+class ProvisionRetailUserRequest {
+}
+exports.ProvisionRetailUserRequest = ProvisionRetailUserRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    __metadata("design:type", String)
+], ProvisionRetailUserRequest.prototype, "email", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ProvisionRetailUserRequest.prototype, "roleId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(PermissionScope_1.PermissionScope),
+    __metadata("design:type", String)
+], ProvisionRetailUserRequest.prototype, "scope", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ProvisionRetailUserRequest.prototype, "scopeRef", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ProvisionRetailUserRequest.prototype, "displayName", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ProvisionRetailUserRequest.prototype, "homeStoreId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(EmploymentTypeEnum_1.EmploymentTypeEnum),
+    __metadata("design:type", String)
+], ProvisionRetailUserRequest.prototype, "employmentType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ProvisionRetailUserRequest.prototype, "commissionTier", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ProvisionRetailUserRequest.prototype, "zoneId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ProvisionRetailUserRequest.prototype, "phone", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(CollectorSeniorityEnum_1.CollectorSeniorityEnum),
+    __metadata("design:type", String)
+], ProvisionRetailUserRequest.prototype, "collectorSeniority", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], ProvisionRetailUserRequest.prototype, "coverageStoreIds", void 0);

package/bin/retailOrg/index.d.ts

@@ -27,6 +27,7 @@ export * from './dtos/requests/CreateStoreRequest';
 export * from './dtos/requests/UpdateStoreRequest';
 export * from './dtos/requests/ChangeStoreStatusRequest';
 export * from './dtos/requests/CreateRetailUserRequest';
+export * from './dtos/requests/ProvisionRetailUserRequest';
 export * from './dtos/requests/UpdateRetailUserRequest';
 export * from './dtos/requests/ChangeRetailUserStatusRequest';
 export * from './dtos/requests/TransferRetailUserRequest';

package/bin/retailOrg/index.js

@@ -47,6 +47,7 @@ __exportStar(require("./dtos/requests/CreateStoreRequest"), exports);
 __exportStar(require("./dtos/requests/UpdateStoreRequest"), exports);
 __exportStar(require("./dtos/requests/ChangeStoreStatusRequest"), exports);
 __exportStar(require("./dtos/requests/CreateRetailUserRequest"), exports);
+__exportStar(require("./dtos/requests/ProvisionRetailUserRequest"), exports);
 __exportStar(require("./dtos/requests/UpdateRetailUserRequest"), exports);
 __exportStar(require("./dtos/requests/ChangeRetailUserStatusRequest"), exports);
 __exportStar(require("./dtos/requests/TransferRetailUserRequest"), exports);

package/bin/retailWizard/dtos/OtpVerification.d.ts

@@ -0,0 +1,24 @@
+import type { OtpPurposeEnum } from '../enums/OtpPurposeEnum';
+/**
+ * Verificación OTP (modelo-datos §2). NO es tabla aparte: vive como ítem en
+ * `<T>RetailWizardSession_GT` (pk `SESSION#<sessionId>` · sk `OTP#<ulid>`) — misma partición de la
+ * sesión → 1 Query trae sesión + OTPs. El código lo genera/valida `messages-business` (D5); aquí
+ * solo trackeamos el `messagesLogId`, nunca el código. SureKeep Fase 2 — pista Retail.
+ */
+export interface OtpVerification {
+    otpId: string;
+    sessionId: string;
+    purpose: OtpPurposeEnum;
+    /** Sustituye al `code_hash` de v0.1 (D5): tracking del envío en messages-business. */
+    messagesLogId: string;
+    channelsDispatched: string[];
+    /** Máx 3 → 423 OTP_MAX_TRIES. */
+    attempts: number;
+    /** 5 min. */
+    expiresAt: string;
+    verifiedAt: string | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: number;
+    updatedAt: number;
+}

package/bin/retailWizard/dtos/OtpVerification.js

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

package/bin/retailWizard/dtos/PaginatedResult.d.ts

@@ -0,0 +1,6 @@
+/** Resultado paginado genérico (cursor opaco `nextToken`). SureKeep Fase 2 — pista Retail. */
+export interface PaginatedResult<T> {
+    items: T[];
+    count: number;
+    nextToken?: string;
+}

package/bin/retailWizard/dtos/PaginatedResult.js

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