@fiado/type-kit 3.258.0 → 3.260.0

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

@@ -0,0 +1,18 @@
+import { InternalAlertChannel } from "../enums/InternalAlertChannelEnum";
+/**
+ * Alerta interna sobre un usuario. Se publica en la cola de alertamiento y zendesk-business
+ * la convierte en una nota interna de Zendesk: solo la ven los agentes, el usuario nunca.
+ *
+ * El asunto del ticket lo genera zendesk-business — es el único campo que el usuario podría
+ * llegar a ver, así que no lo escribe el caller.
+ */
+export declare class ZendeskInternalAlertRequest {
+    /** Usuario sobre el que se alerta. */
+    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;
+    /** Id del evento origen, para rastrear la alerta de vuelta. */
+    reference?: string;
+}

package/bin/helpdesk/dtos/ZendeskInternalAlertRequest.js

@@ -0,0 +1,43 @@
+"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.ZendeskInternalAlertRequest = void 0;
+const class_validator_1 = require("class-validator");
+const InternalAlertChannelEnum_1 = require("../enums/InternalAlertChannelEnum");
+/**
+ * Alerta interna sobre un usuario. Se publica en la cola de alertamiento y zendesk-business
+ * la convierte en una nota interna de Zendesk: solo la ven los agentes, el usuario nunca.
+ *
+ * El asunto del ticket lo genera zendesk-business — es el único campo que el usuario podría
+ * llegar a ver, así que no lo escribe el caller.
+ */
+class ZendeskInternalAlertRequest {
+}
+exports.ZendeskInternalAlertRequest = ZendeskInternalAlertRequest;
+__decorate([
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ZendeskInternalAlertRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsString)(),
+    __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);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], ZendeskInternalAlertRequest.prototype, "reference", void 0);

package/bin/helpdesk/enums/InternalAlertChannelEnum.d.ts

@@ -0,0 +1,7 @@
+/** Canal de una alerta interna: decide el ruteo dentro de Zendesk (tag, vista y equipo). */
+export declare enum InternalAlertChannel {
+    /** Alertas operativas que resuelve el equipo interno sin involucrar al usuario. */
+    INTERNAL = "INTERNAL",
+    /** Alertas de cumplimiento regulatorio. El usuario no puede enterarse. */
+    COMPLIANCE = "COMPLIANCE"
+}

package/bin/helpdesk/enums/InternalAlertChannelEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InternalAlertChannel = void 0;
+/** Canal de una alerta interna: decide el ruteo dentro de Zendesk (tag, vista y equipo). */
+var InternalAlertChannel;
+(function (InternalAlertChannel) {
+    /** Alertas operativas que resuelve el equipo interno sin involucrar al usuario. */
+    InternalAlertChannel["INTERNAL"] = "INTERNAL";
+    /** Alertas de cumplimiento regulatorio. El usuario no puede enterarse. */
+    InternalAlertChannel["COMPLIANCE"] = "COMPLIANCE";
+})(InternalAlertChannel || (exports.InternalAlertChannel = InternalAlertChannel = {}));

package/bin/helpdesk/enums/ZendeskAlertKindEnum.d.ts

@@ -0,0 +1,7 @@
+/** Discrimina qué transporta un mensaje de la cola de alertamiento de Zendesk. */
+export declare enum ZendeskAlertKind {
+    /** Nota interna en un ticket: solo la ven los agentes. */
+    INTERNAL_NOTE = "INTERNAL_NOTE",
+    /** Mensaje proactivo al chat del usuario. */
+    PROACTIVE_MESSAGE = "PROACTIVE_MESSAGE"
+}

package/bin/helpdesk/enums/ZendeskAlertKindEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZendeskAlertKind = void 0;
+/** Discrimina qué transporta un mensaje de la cola de alertamiento de Zendesk. */
+var ZendeskAlertKind;
+(function (ZendeskAlertKind) {
+    /** Nota interna en un ticket: solo la ven los agentes. */
+    ZendeskAlertKind["INTERNAL_NOTE"] = "INTERNAL_NOTE";
+    /** Mensaje proactivo al chat del usuario. */
+    ZendeskAlertKind["PROACTIVE_MESSAGE"] = "PROACTIVE_MESSAGE";
+})(ZendeskAlertKind || (exports.ZendeskAlertKind = ZendeskAlertKind = {}));

package/bin/helpdesk/index.d.ts

@@ -1,2 +1,6 @@
 export * from './dtos/HelpdeskCreateUserRequest';
 export * from './dtos/HelpdeskCreateTicketRequest';
+export * from './dtos/ZendeskInternalAlertRequest';
+export * from './enums/InternalAlertChannelEnum';
+export * from './enums/ZendeskAlertKindEnum';
+export * from './interfaces/IZendeskAlertMessage';

package/bin/helpdesk/index.js

@@ -16,3 +16,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./dtos/HelpdeskCreateUserRequest"), exports);
 __exportStar(require("./dtos/HelpdeskCreateTicketRequest"), exports);
+// Alertamiento interno (cola de Zendesk)
+__exportStar(require("./dtos/ZendeskInternalAlertRequest"), exports);
+__exportStar(require("./enums/InternalAlertChannelEnum"), exports);
+__exportStar(require("./enums/ZendeskAlertKindEnum"), exports);
+__exportStar(require("./interfaces/IZendeskAlertMessage"), exports);

package/bin/helpdesk/interfaces/IZendeskAlertMessage.d.ts

@@ -0,0 +1,6 @@
+import { ZendeskAlertKind } from "../enums/ZendeskAlertKindEnum";
+/** Sobre de un mensaje de la cola de alertamiento: `kind` decide cómo interpretar `payload`. */
+export interface IZendeskAlertMessage<TPayload = unknown> {
+    kind: ZendeskAlertKind;
+    payload: TPayload;
+}

package/bin/helpdesk/interfaces/IZendeskAlertMessage.js

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

package/bin/onboarding/enums/OnboardingAccountReasonEnum.d.ts

@@ -22,5 +22,8 @@ export declare enum OnboardingAccountReasonEnum {
     /** Solo lado USA: el proveedor rechazó. */
     PROVIDER_DENIED = "PROVIDER_DENIED",
     /** Solo lado USA: el proveedor está revisando o pidiendo documento. */
-    PROVIDER_REVIEW = "PROVIDER_REVIEW"
+    PROVIDER_REVIEW = "PROVIDER_REVIEW",
+    /** Solo lado USA: el proveedor espera que el usuario conteste las preguntas OOW (Out of Wallet).
+     *  `CP_Status === PENDING_OOW_QUESTIONS`. La app rutea a la pantalla de preguntas por este reason. */
+    PENDING_OOW_QUESTIONS = "PENDING_OOW_QUESTIONS"
 }

package/bin/onboarding/enums/OnboardingAccountReasonEnum.js

@@ -27,4 +27,7 @@ var OnboardingAccountReasonEnum;
     OnboardingAccountReasonEnum["PROVIDER_DENIED"] = "PROVIDER_DENIED";
     /** Solo lado USA: el proveedor está revisando o pidiendo documento. */
     OnboardingAccountReasonEnum["PROVIDER_REVIEW"] = "PROVIDER_REVIEW";
+    /** Solo lado USA: el proveedor espera que el usuario conteste las preguntas OOW (Out of Wallet).
+     *  `CP_Status === PENDING_OOW_QUESTIONS`. La app rutea a la pantalla de preguntas por este reason. */
+    OnboardingAccountReasonEnum["PENDING_OOW_QUESTIONS"] = "PENDING_OOW_QUESTIONS";
 })(OnboardingAccountReasonEnum || (exports.OnboardingAccountReasonEnum = OnboardingAccountReasonEnum = {}));

package/bin/onboarding/enums/OnboardingStepIdEnum.d.ts

@@ -1,6 +1,6 @@
 /**
- * Los 7 pasos del onboarding, resueltos por los scopes del usuario y NO por país (DEC-009, DEC-010 de
- * onboarding-business).
+ * Los pasos del onboarding, resueltos por los scopes del usuario y NO por país (DEC-009, DEC-010 de
+ * onboarding-business). `SSN_ITIN` es solo del lado USA.
  *
  * El orden de este enum no define el orden de pintado: la respuesta trae los pasos ya ordenados y la
  * app pinta el array tal como llega.
@@ -13,6 +13,7 @@
  */
 export declare enum OnboardingStepIdEnum {
     KYC_IDENTIFICATION = "KYC_IDENTIFICATION",
+    SSN_ITIN = "SSN_ITIN",
     INCOME_INFORMATION = "INCOME_INFORMATION",
     US_ADDRESS = "US_ADDRESS",
     PROOF_OF_ADDRESS = "PROOF_OF_ADDRESS",

package/bin/onboarding/enums/OnboardingStepIdEnum.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OnboardingStepIdEnum = void 0;
 /**
- * Los 7 pasos del onboarding, resueltos por los scopes del usuario y NO por país (DEC-009, DEC-010 de
- * onboarding-business).
+ * Los pasos del onboarding, resueltos por los scopes del usuario y NO por país (DEC-009, DEC-010 de
+ * onboarding-business). `SSN_ITIN` es solo del lado USA.
  *
  * El orden de este enum no define el orden de pintado: la respuesta trae los pasos ya ordenados y la
  * app pinta el array tal como llega.
@@ -17,6 +17,7 @@ exports.OnboardingStepIdEnum = void 0;
 var OnboardingStepIdEnum;
 (function (OnboardingStepIdEnum) {
     OnboardingStepIdEnum["KYC_IDENTIFICATION"] = "KYC_IDENTIFICATION";
+    OnboardingStepIdEnum["SSN_ITIN"] = "SSN_ITIN";
     OnboardingStepIdEnum["INCOME_INFORMATION"] = "INCOME_INFORMATION";
     OnboardingStepIdEnum["US_ADDRESS"] = "US_ADDRESS";
     OnboardingStepIdEnum["PROOF_OF_ADDRESS"] = "PROOF_OF_ADDRESS";

package/package.json

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

package/src/helpdesk/dtos/ZendeskInternalAlertRequest.ts

@@ -0,0 +1,31 @@
+import { IsEnum, IsNotEmpty, IsOptional, IsString } from "class-validator";
+import { InternalAlertChannel } from "../enums/InternalAlertChannelEnum";
+
+/**
+ * Alerta interna sobre un usuario. Se publica en la cola de alertamiento y zendesk-business
+ * la convierte en una nota interna de Zendesk: solo la ven los agentes, el usuario nunca.
+ *
+ * El asunto del ticket lo genera zendesk-business — es el único campo que el usuario podría
+ * llegar a ver, así que no lo escribe el caller.
+ */
+export class ZendeskInternalAlertRequest {
+
+    /** Usuario sobre el que se alerta. */
+    @IsNotEmpty()
+    @IsString()
+    directoryId: string;
+
+    /** Detalle del problema. Acá va lo sensible: es lo que se escribe como nota interna. */
+    @IsNotEmpty()
+    @IsString()
+    note: string;
+
+    /** Decide el ruteo en Zendesk (tag, vista y equipo). */
+    @IsEnum(InternalAlertChannel)
+    channel: InternalAlertChannel;
+
+    /** Id del evento origen, para rastrear la alerta de vuelta. */
+    @IsString()
+    @IsOptional()
+    reference?: string;
+}

package/src/helpdesk/enums/InternalAlertChannelEnum.ts

@@ -0,0 +1,7 @@
+/** Canal de una alerta interna: decide el ruteo dentro de Zendesk (tag, vista y equipo). */
+export enum InternalAlertChannel {
+    /** Alertas operativas que resuelve el equipo interno sin involucrar al usuario. */
+    INTERNAL = 'INTERNAL',
+    /** Alertas de cumplimiento regulatorio. El usuario no puede enterarse. */
+    COMPLIANCE = 'COMPLIANCE'
+}

package/src/helpdesk/enums/ZendeskAlertKindEnum.ts

@@ -0,0 +1,7 @@
+/** Discrimina qué transporta un mensaje de la cola de alertamiento de Zendesk. */
+export enum ZendeskAlertKind {
+    /** Nota interna en un ticket: solo la ven los agentes. */
+    INTERNAL_NOTE = 'INTERNAL_NOTE',
+    /** Mensaje proactivo al chat del usuario. */
+    PROACTIVE_MESSAGE = 'PROACTIVE_MESSAGE'
+}

package/src/helpdesk/index.ts

@@ -1,2 +1,8 @@
 export * from './dtos/HelpdeskCreateUserRequest';
-export * from './dtos/HelpdeskCreateTicketRequest';
+export * from './dtos/HelpdeskCreateTicketRequest';
+
+// Alertamiento interno (cola de Zendesk)
+export * from './dtos/ZendeskInternalAlertRequest';
+export * from './enums/InternalAlertChannelEnum';
+export * from './enums/ZendeskAlertKindEnum';
+export * from './interfaces/IZendeskAlertMessage';

package/src/helpdesk/interfaces/IZendeskAlertMessage.ts

@@ -0,0 +1,7 @@
+import { ZendeskAlertKind } from "../enums/ZendeskAlertKindEnum";
+
+/** Sobre de un mensaje de la cola de alertamiento: `kind` decide cómo interpretar `payload`. */
+export interface IZendeskAlertMessage<TPayload = unknown> {
+    kind: ZendeskAlertKind;
+    payload: TPayload;
+}

package/src/onboarding/enums/OnboardingAccountReasonEnum.ts

@@ -23,4 +23,7 @@ export enum OnboardingAccountReasonEnum {
     PROVIDER_DENIED = 'PROVIDER_DENIED',
     /** Solo lado USA: el proveedor está revisando o pidiendo documento. */
     PROVIDER_REVIEW = 'PROVIDER_REVIEW',
+    /** Solo lado USA: el proveedor espera que el usuario conteste las preguntas OOW (Out of Wallet).
+     *  `CP_Status === PENDING_OOW_QUESTIONS`. La app rutea a la pantalla de preguntas por este reason. */
+    PENDING_OOW_QUESTIONS = 'PENDING_OOW_QUESTIONS',
 }

package/src/onboarding/enums/OnboardingStepIdEnum.ts

@@ -1,6 +1,6 @@
 /**
- * Los 7 pasos del onboarding, resueltos por los scopes del usuario y NO por país (DEC-009, DEC-010 de
- * onboarding-business).
+ * Los pasos del onboarding, resueltos por los scopes del usuario y NO por país (DEC-009, DEC-010 de
+ * onboarding-business). `SSN_ITIN` es solo del lado USA.
  *
  * El orden de este enum no define el orden de pintado: la respuesta trae los pasos ya ordenados y la
  * app pinta el array tal como llega.
@@ -13,6 +13,7 @@
  */
 export enum OnboardingStepIdEnum {
     KYC_IDENTIFICATION = 'KYC_IDENTIFICATION',
+    SSN_ITIN = 'SSN_ITIN',
     INCOME_INFORMATION = 'INCOME_INFORMATION',
     US_ADDRESS = 'US_ADDRESS',
     PROOF_OF_ADDRESS = 'PROOF_OF_ADDRESS',