@fiado/type-kit 3.171.0 → 3.173.0

package/_test_/unit/remittance/kycOnboardingAttempt.test.ts

@@ -0,0 +1,46 @@
+import {
+    KycOnboardingAttempt,
+    KycOnboardingAttemptsResponse,
+    RegisterOnboardingBlockRequest,
+} from "../../../src/remittance/dtos/RemittanceKyc";
+
+describe("KycOnboardingAttempt DTOs", () => {
+    it("acepta un intento con request/response completos (verbatim) y una lista", () => {
+        const attempt: KycOnboardingAttempt = {
+            attemptId: "2026-07-09T10:00:00.000Z#a1b2c3d4",
+            at: "2026-07-09T10:00:00.000Z",
+            outcome: "SUCCESS",
+            phase: "COMPLETE",
+            responseCode: "00000000",
+            rejectionCode: null,
+            rejectionMessage: null,
+            // JSON completo tal cual (payload externo de UNIR)
+            request: { partnerCode: "XX", agreementLocale: "ES", remitterPersonalInfo: { emailAddress: "a@b.com", firstName: "MARIA", lastName: "GOMEZ", cellPhone: "2024021401" } },
+            response: { responseCode: "00000000", extraFields: [] },
+        };
+        const list: KycOnboardingAttemptsResponse = { items: [attempt] };
+        expect(list.items[0].outcome).toBe("SUCCESS");
+        expect((list.items[0].request as Record<string, any>).remitterPersonalInfo.firstName).toBe("MARIA");
+    });
+
+    it("permite request/response null (bloqueo por dirección)", () => {
+        const blocked: KycOnboardingAttempt = {
+            attemptId: "2026-07-08T09:00:00.000Z#33aa22bb",
+            at: "2026-07-08T09:00:00.000Z",
+            outcome: "BLOCKED",
+            phase: "ADDRESS_BLOCK",
+            responseCode: null,
+            rejectionCode: "NO_PRINCIPAL_ADDRESS",
+            rejectionMessage: "Usuario sin dirección principal US",
+            request: null,
+            response: null,
+        };
+        expect(blocked.request).toBeNull();
+        expect(blocked.rejectionCode).toBe("NO_PRINCIPAL_ADDRESS");
+    });
+
+    it("RegisterOnboardingBlockRequest tiene la forma esperada", () => {
+        const block: RegisterOnboardingBlockRequest = { directoryId: "d1", email: "a@b.com", code: "NO_PRINCIPAL_ADDRESS", message: "x" };
+        expect(block.code).toBe("NO_PRINCIPAL_ADDRESS");
+    });
+});

package/bin/places/enums/EstablishmentBrandEnum.d.ts

@@ -1,6 +1,7 @@
 export declare enum EstablishmentBrandEnum {
     CVS = "CVS",
     DOLLAR_TREE = "DOLLAR_TREE",
+    FAMILY_DOLLAR = "FAMILY_DOLLAR",
     WALMART = "WALMART",
     SEVEN_ELEVEN = "SEVEN_ELEVEN",
     AL_SUPER = "AL_SUPER",

package/bin/places/enums/EstablishmentBrandEnum.js

@@ -6,6 +6,7 @@ var EstablishmentBrandEnum;
     // --- Solo US (GreenDot) ---
     EstablishmentBrandEnum["CVS"] = "CVS";
     EstablishmentBrandEnum["DOLLAR_TREE"] = "DOLLAR_TREE";
+    EstablishmentBrandEnum["FAMILY_DOLLAR"] = "FAMILY_DOLLAR";
     // RITE_AID eliminada (2026-06-24): la cadena desapareció tras su bancarrota de 2025.
     // --- Compartidas US (GreenDot) y MX (Passport): el PAÍS define el proveedor ---
     EstablishmentBrandEnum["WALMART"] = "WALMART";

package/bin/remittance/dtos/RemittanceKyc.d.ts

@@ -68,3 +68,45 @@ export declare class RefreshUserProfileResponse {
     remitterLevel: string | null;
     lastDataSyncAt: string;
 }
+/** Resultado de un intento de onboarding (SignUp) contra UNIR. */
+export type OnboardingAttemptOutcome = "SUCCESS" | "REJECTED" | "ERROR" | "BLOCKED";
+/**
+ * Un intento de onboarding contra UNIR (audit — `RemittanceOnboardingAttempts_GT`).
+ *
+ * `request`/`response` son el JSON COMPLETO tal cual (verbatim) que se envió/recibió del
+ * SignUp — payload externo de UNIR, por eso se tipa a propósito como `Record<string, unknown>`
+ * (no se cura campo por campo: el requerimiento es NO omitir nada; el connector lo persiste
+ * cifrado con KMS). Son `null` cuando no hubo SignUp (bloqueo por dirección o fallo previo).
+ */
+export declare class KycOnboardingAttempt {
+    /** `${at}#${uuid8}` — ordenable por tiempo. */
+    attemptId: string;
+    /** ISO-8601. */
+    at: string;
+    outcome: OnboardingAttemptOutcome;
+    /** SIGNUP | COMPLETE | PASSWORD_GRANT | WALLET | ADDRESS_BLOCK. */
+    phase: string;
+    /** Extraído en claro para lista/filtro (no es la fuente de verdad). */
+    responseCode: string | null;
+    rejectionCode: string | null;
+    rejectionMessage: string | null;
+    request: Record<string, unknown> | null;
+    response: Record<string, unknown> | null;
+}
+/** Historial de intentos de onboarding de un usuario (orden descendente por `at`). */
+export declare class KycOnboardingAttemptsResponse {
+    items: KycOnboardingAttempt[];
+}
+/** #3 — Body para registrar un onboarding bloqueado por dirección (deja PENDING + rejection). */
+export declare class RegisterOnboardingBlockRequest {
+    directoryId: string;
+    email: string;
+    /** NO_PRINCIPAL_ADDRESS | MULTIPLE_PRINCIPAL_ADDRESS | INCOMPLETE_ADDRESS. */
+    code: string;
+    message: string;
+}
+export declare class RegisterOnboardingBlockResponse {
+    directoryId: string;
+    status: string;
+    rejectionCode: string;
+}

package/bin/remittance/dtos/RemittanceKyc.js

@@ -7,7 +7,7 @@
  * `lastRejection` es el último rechazo persistido (MVP guarda solo el último).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RefreshUserProfileResponse = exports.KycUsersListResponse = exports.KycUserDetail = exports.KycUserSummary = exports.KycUserIdentity = exports.KycUserAddress = exports.KycRejection = void 0;
+exports.RegisterOnboardingBlockResponse = exports.RegisterOnboardingBlockRequest = exports.KycOnboardingAttemptsResponse = exports.KycOnboardingAttempt = exports.RefreshUserProfileResponse = exports.KycUsersListResponse = exports.KycUserDetail = exports.KycUserSummary = exports.KycUserIdentity = exports.KycUserAddress = exports.KycRejection = void 0;
 class KycRejection {
 }
 exports.KycRejection = KycRejection;
@@ -34,3 +34,25 @@ exports.KycUsersListResponse = KycUsersListResponse;
 class RefreshUserProfileResponse {
 }
 exports.RefreshUserProfileResponse = RefreshUserProfileResponse;
+/**
+ * Un intento de onboarding contra UNIR (audit — `RemittanceOnboardingAttempts_GT`).
+ *
+ * `request`/`response` son el JSON COMPLETO tal cual (verbatim) que se envió/recibió del
+ * SignUp — payload externo de UNIR, por eso se tipa a propósito como `Record<string, unknown>`
+ * (no se cura campo por campo: el requerimiento es NO omitir nada; el connector lo persiste
+ * cifrado con KMS). Son `null` cuando no hubo SignUp (bloqueo por dirección o fallo previo).
+ */
+class KycOnboardingAttempt {
+}
+exports.KycOnboardingAttempt = KycOnboardingAttempt;
+/** Historial de intentos de onboarding de un usuario (orden descendente por `at`). */
+class KycOnboardingAttemptsResponse {
+}
+exports.KycOnboardingAttemptsResponse = KycOnboardingAttemptsResponse;
+/** #3 — Body para registrar un onboarding bloqueado por dirección (deja PENDING + rejection). */
+class RegisterOnboardingBlockRequest {
+}
+exports.RegisterOnboardingBlockRequest = RegisterOnboardingBlockRequest;
+class RegisterOnboardingBlockResponse {
+}
+exports.RegisterOnboardingBlockResponse = RegisterOnboardingBlockResponse;

package/package.json

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

package/src/places/enums/EstablishmentBrandEnum.ts

@@ -2,6 +2,7 @@ export enum EstablishmentBrandEnum {
     // --- Solo US (GreenDot) ---
     CVS = 'CVS',
     DOLLAR_TREE = 'DOLLAR_TREE',
+    FAMILY_DOLLAR = 'FAMILY_DOLLAR',
     // RITE_AID eliminada (2026-06-24): la cadena desapareció tras su bancarrota de 2025.
 
     // --- Compartidas US (GreenDot) y MX (Passport): el PAÍS define el proveedor ---

package/src/remittance/dtos/RemittanceKyc.ts

@@ -75,3 +75,50 @@ export class RefreshUserProfileResponse {
     remitterLevel!: string | null;
     lastDataSyncAt!: string;
 }
+
+/** Resultado de un intento de onboarding (SignUp) contra UNIR. */
+export type OnboardingAttemptOutcome = "SUCCESS" | "REJECTED" | "ERROR" | "BLOCKED";
+
+/**
+ * Un intento de onboarding contra UNIR (audit — `RemittanceOnboardingAttempts_GT`).
+ *
+ * `request`/`response` son el JSON COMPLETO tal cual (verbatim) que se envió/recibió del
+ * SignUp — payload externo de UNIR, por eso se tipa a propósito como `Record<string, unknown>`
+ * (no se cura campo por campo: el requerimiento es NO omitir nada; el connector lo persiste
+ * cifrado con KMS). Son `null` cuando no hubo SignUp (bloqueo por dirección o fallo previo).
+ */
+export class KycOnboardingAttempt {
+    /** `${at}#${uuid8}` — ordenable por tiempo. */
+    attemptId!: string;
+    /** ISO-8601. */
+    at!: string;
+    outcome!: OnboardingAttemptOutcome;
+    /** SIGNUP | COMPLETE | PASSWORD_GRANT | WALLET | ADDRESS_BLOCK. */
+    phase!: string;
+    /** Extraído en claro para lista/filtro (no es la fuente de verdad). */
+    responseCode!: string | null;
+    rejectionCode!: string | null;
+    rejectionMessage!: string | null;
+    request!: Record<string, unknown> | null;
+    response!: Record<string, unknown> | null;
+}
+
+/** Historial de intentos de onboarding de un usuario (orden descendente por `at`). */
+export class KycOnboardingAttemptsResponse {
+    items!: KycOnboardingAttempt[];
+}
+
+/** #3 — Body para registrar un onboarding bloqueado por dirección (deja PENDING + rejection). */
+export class RegisterOnboardingBlockRequest {
+    directoryId!: string;
+    email!: string;
+    /** NO_PRINCIPAL_ADDRESS | MULTIPLE_PRINCIPAL_ADDRESS | INCOMPLETE_ADDRESS. */
+    code!: string;
+    message!: string;
+}
+
+export class RegisterOnboardingBlockResponse {
+    directoryId!: string;
+    status!: string;                    // PENDING
+    rejectionCode!: string;
+}