@fiado/type-kit 3.447.0 → 3.449.0

package/_test_/unit/card/LevelOneAutoIssuanceTags.test.ts

@@ -0,0 +1,22 @@
+import 'reflect-metadata';
+import { LEVEL_ONE_AUTO_ISSUANCE_TAGS, hasLevelOneAutoIssuanceTag } from '../../../src/card/index';
+
+describe('LEVEL_ONE_AUTO_ISSUANCE_TAGS', () => {
+  it('incluye el tag de Surekeep, el primer origen habilitado', () => {
+    expect(LEVEL_ONE_AUTO_ISSUANCE_TAGS).toContain('wh:surekeep');
+  });
+
+  it('hasLevelOneAutoIssuanceTag: basta con que UNO de los tags del directorio esté habilitado', () => {
+    expect(hasLevelOneAutoIssuanceTag(['otro', 'wh:surekeep'])).toBe(true);
+  });
+
+  it('hasLevelOneAutoIssuanceTag: sin tag habilitado → false', () => {
+    expect(hasLevelOneAutoIssuanceTag(['wh:otro'])).toBe(false);
+    expect(hasLevelOneAutoIssuanceTag([])).toBe(false);
+  });
+
+  it('hasLevelOneAutoIssuanceTag: sin lista (null/undefined) → false, fail-closed', () => {
+    expect(hasLevelOneAutoIssuanceTag(null)).toBe(false);
+    expect(hasLevelOneAutoIssuanceTag(undefined)).toBe(false);
+  });
+});

package/bin/card/constants/LevelOneAutoIssuanceTags.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tags de directorio (UserTags_GT) que habilitan la apertura AUTOMÁTICA de la cuenta MX en nivel 1
+ * con expediente simplificado y sin contrato de PagoConfiado.
+ *
+ * Vive acá, y no en cada servicio, porque la leen DOS consumidores que deben coincidir:
+ * onboarding-business (decide y dispara con `mexAccountLevel: LEVEL_1`) y fiado-card-business
+ * (re-verifica el tag antes de honrar ese nivel). Para habilitar un origen nuevo se agrega el tag a
+ * esta lista y se bumpea type-kit en ambos.
+ */
+export declare const LEVEL_ONE_AUTO_ISSUANCE_TAGS: readonly string[];
+/** ¿Alguno de los tags del directorio habilita el nivel 1 automático? Fail-closed: sin lista, no. */
+export declare function hasLevelOneAutoIssuanceTag(tags: readonly string[] | null | undefined): boolean;

package/bin/card/constants/LevelOneAutoIssuanceTags.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEVEL_ONE_AUTO_ISSUANCE_TAGS = void 0;
+exports.hasLevelOneAutoIssuanceTag = hasLevelOneAutoIssuanceTag;
+/**
+ * Tags de directorio (UserTags_GT) que habilitan la apertura AUTOMÁTICA de la cuenta MX en nivel 1
+ * con expediente simplificado y sin contrato de PagoConfiado.
+ *
+ * Vive acá, y no en cada servicio, porque la leen DOS consumidores que deben coincidir:
+ * onboarding-business (decide y dispara con `mexAccountLevel: LEVEL_1`) y fiado-card-business
+ * (re-verifica el tag antes de honrar ese nivel). Para habilitar un origen nuevo se agrega el tag a
+ * esta lista y se bumpea type-kit en ambos.
+ */
+exports.LEVEL_ONE_AUTO_ISSUANCE_TAGS = [
+    "wh:surekeep",
+];
+/** ¿Alguno de los tags del directorio habilita el nivel 1 automático? Fail-closed: sin lista, no. */
+function hasLevelOneAutoIssuanceTag(tags) {
+    return Array.isArray(tags) && tags.some((tag) => exports.LEVEL_ONE_AUTO_ISSUANCE_TAGS.includes(tag));
+}

package/bin/card/dtos/CardIssuanceBySideRequest.d.ts

@@ -16,9 +16,9 @@ export declare class CardIssuanceBySideRequest {
     USA_InfoSelfVerified?: InfoSelfVerifiedStatus;
     /**
      * Nivel de cuenta MX que el evaluador (onboarding-business) resolvió para este disparo.
-     * Hoy sólo LEVEL_1, para usuarios con tag `wh:surekeep`: expediente simplificado y sin
-     * contrato de PagoConfiado. Ausente = comportamiento histórico (el nivel lo decide el
-     * expediente en card-business).
+     * Hoy sólo LEVEL_1, para directorios con un tag de `LEVEL_ONE_AUTO_ISSUANCE_TAGS`: expediente
+     * simplificado y sin contrato de PagoConfiado. Ausente = comportamiento histórico (el nivel lo
+     * decide el expediente en card-business).
      */
     mexAccountLevel?: AccountLevelEnum;
 }

package/bin/card/index.d.ts

@@ -71,3 +71,4 @@ export * from './enums/ReplaceBankAccountCardReasonEnum';
 export * from './enums/CardReasonStatus';
 export * from './enums/KycReason';
 export * from './enums/PinChangedStatus';
+export * from './constants/LevelOneAutoIssuanceTags';

package/bin/card/index.js

@@ -90,3 +90,4 @@ __exportStar(require("./enums/ReplaceBankAccountCardReasonEnum"), exports);
 __exportStar(require("./enums/CardReasonStatus"), exports);
 __exportStar(require("./enums/KycReason"), exports);
 __exportStar(require("./enums/PinChangedStatus"), exports);
+__exportStar(require("./constants/LevelOneAutoIssuanceTags"), exports);

package/bin/transaction/dtos/AuthorizeRefundRequest.d.ts

@@ -21,7 +21,15 @@ export interface AuthorizeRefundRequest {
         caseFolio: string;
         originalTransactionId: string | null;
         originalAmount: number;
-        originalChannel: 'PCF_P2P' | 'SPEI_IN' | 'SPEI_OUT' | 'CARD' | 'DOMICILIATION_FSA';
+        /**
+         * Canal de la operación original reclamada, desde la perspectiva PCF.
+         * PCF solo opera SPEI, P2P entre wallets Fiado, domiciliaciones y transferencias
+         * intra-banco (BBVA↔BBVA — por ejemplo, cuando FSA regresa dinero a PCF por
+         * reversa de tarjeta o desembolso de crédito). PCF NO opera tarjetas ni
+         * servicios directamente; esas operaciones aparecen en el wallet PCF como
+         * domiciliaciones o transferencias intra-banco autorizadas.
+         */
+        originalChannel: 'PCF_P2P' | 'SPEI_IN' | 'SPEI_OUT' | 'DOMICILIATION' | 'INTRA_BANK_TRANSFER';
     };
     approval: {
         makerUserId: string;

package/package.json

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

package/src/card/constants/LevelOneAutoIssuanceTags.ts

@@ -0,0 +1,17 @@
+/**
+ * Tags de directorio (UserTags_GT) que habilitan la apertura AUTOMÁTICA de la cuenta MX en nivel 1
+ * con expediente simplificado y sin contrato de PagoConfiado.
+ *
+ * Vive acá, y no en cada servicio, porque la leen DOS consumidores que deben coincidir:
+ * onboarding-business (decide y dispara con `mexAccountLevel: LEVEL_1`) y fiado-card-business
+ * (re-verifica el tag antes de honrar ese nivel). Para habilitar un origen nuevo se agrega el tag a
+ * esta lista y se bumpea type-kit en ambos.
+ */
+export const LEVEL_ONE_AUTO_ISSUANCE_TAGS: readonly string[] = [
+    "wh:surekeep",
+];
+
+/** ¿Alguno de los tags del directorio habilita el nivel 1 automático? Fail-closed: sin lista, no. */
+export function hasLevelOneAutoIssuanceTag(tags: readonly string[] | null | undefined): boolean {
+    return Array.isArray(tags) && tags.some((tag) => LEVEL_ONE_AUTO_ISSUANCE_TAGS.includes(tag));
+}

package/src/card/dtos/CardIssuanceBySideRequest.ts

@@ -30,9 +30,9 @@ export class CardIssuanceBySideRequest {
 
     /**
      * Nivel de cuenta MX que el evaluador (onboarding-business) resolvió para este disparo.
-     * Hoy sólo LEVEL_1, para usuarios con tag `wh:surekeep`: expediente simplificado y sin
-     * contrato de PagoConfiado. Ausente = comportamiento histórico (el nivel lo decide el
-     * expediente en card-business).
+     * Hoy sólo LEVEL_1, para directorios con un tag de `LEVEL_ONE_AUTO_ISSUANCE_TAGS`: expediente
+     * simplificado y sin contrato de PagoConfiado. Ausente = comportamiento histórico (el nivel lo
+     * decide el expediente en card-business).
      */
     @IsOptional()
     @IsEnum(AccountLevelEnum)

package/src/card/index.ts

@@ -77,4 +77,4 @@ export * from './enums/ReplaceBankAccountCardReasonEnum'
 export * from './enums/CardReasonStatus'
 export * from './enums/KycReason'
 export * from './enums/PinChangedStatus'
-
+export * from './constants/LevelOneAutoIssuanceTags';

package/src/transaction/dtos/AuthorizeRefundRequest.ts

@@ -19,7 +19,15 @@ export interface AuthorizeRefundRequest {
         caseFolio: string;
         originalTransactionId: string | null;
         originalAmount: number;
-        originalChannel: 'PCF_P2P' | 'SPEI_IN' | 'SPEI_OUT' | 'CARD' | 'DOMICILIATION_FSA';
+        /**
+         * Canal de la operación original reclamada, desde la perspectiva PCF.
+         * PCF solo opera SPEI, P2P entre wallets Fiado, domiciliaciones y transferencias
+         * intra-banco (BBVA↔BBVA — por ejemplo, cuando FSA regresa dinero a PCF por
+         * reversa de tarjeta o desembolso de crédito). PCF NO opera tarjetas ni
+         * servicios directamente; esas operaciones aparecen en el wallet PCF como
+         * domiciliaciones o transferencias intra-banco autorizadas.
+         */
+        originalChannel: 'PCF_P2P' | 'SPEI_IN' | 'SPEI_OUT' | 'DOMICILIATION' | 'INTRA_BANK_TRANSFER';
     };
     approval: {
         makerUserId: string;