@fiado/type-kit 3.620.0 → 3.621.0

package/_test_/unit/retailIntegration/reconciliationContracts.test.ts

@@ -119,6 +119,24 @@ describe('respuestas de la revisión', () => {
     expect(catalog.storesPending).toBe(0);
   });
 
+  it('las respuestas GET exponen el motivo del aborto, el último error y el intento', () => {
+    const counts = { seen: 0, created: 0, updated: 0, deactivated: 0, reactivated: 0, skipped: 0 };
+    const org: GetOrgReconciliationResponse = {
+      runId: 'run-o', retailerId: 'r-1', entity: ReconciliationEntityEnum.STORES,
+      status: ReconciliationRunStatusEnum.ABORTED, trigger: ReconciliationTriggerEnum.MANUAL,
+      startedAt: '2026-10-25T10:00:00.000Z', pagesProcessed: 0, counts,
+      abortReason: 'RETAIL_INTEGRATION_CONNECTOR_UNAVAILABLE', lastErrorCode: 'RETAIL_INTEGRATION_CONNECTOR_UNAVAILABLE', attempt: 1, maxAttempts: 5,
+    };
+    const catalog: GetCatalogReconciliationResponse = {
+      runId: 'run-c', retailerId: 'r-1', entity: ReconciliationEntityEnum.CATALOG,
+      status: ReconciliationRunStatusEnum.RUNNING, trigger: ReconciliationTriggerEnum.SCHEDULED,
+      startedAt: '2026-10-25T10:00:00.000Z', pagesProcessed: 0, counts,
+      abortReason: null, lastErrorCode: 'RETAIL_INTEGRATION_CONNECTOR_UNAVAILABLE', attempt: 3, maxAttempts: 5,
+    };
+    expect(org.abortReason).toBe('RETAIL_INTEGRATION_CONNECTOR_UNAVAILABLE');
+    expect([catalog.attempt, catalog.maxAttempts]).toEqual([3, 5]);
+  });
+
   it('GetCatalogReconciliationResponse admite MOVEMENTS con su ventana', () => {
     const movements: GetCatalogReconciliationResponse = {
       runId: 'run-m',

package/bin/retailIntegration/dtos/GetReconciliationResponses.d.ts

@@ -3,8 +3,19 @@ import type { ReconciliationRunStatusEnum } from '../enums/ReconciliationRunStat
 import type { ReconciliationTriggerEnum } from '../enums/ReconciliationTriggerEnum';
 import type { ReconciliationPreview } from './ReconciliationPreview';
 import type { ReconciliationRunCounts } from './ReconciliationRunCounts';
+/** Fallos de una corrida: por qué se abortó y en qué intento de SQS va la página que falla. */
+export interface ReconciliationRunAttempts {
+    /** Motivo del ABORTED (`MAX_ATTEMPTS`, `ROW_WITHOUT_ID`, el `code` del externo caído, etc.); null si no se abortó. */
+    abortReason?: string | null;
+    /** `code` del último error de la página en curso; null si la página no ha fallado. */
+    lastErrorCode?: string | null;
+    /** Intento de SQS (1-based) en que falló la página en curso; null si no ha fallado. */
+    attempt?: number | null;
+    /** Intentos de SQS que tiene una página antes de abortar la corrida. */
+    maxAttempts?: number;
+}
 /** Respuesta 200 de GET .../reconciliations/{runId} en org (backofficeGetOrgReconciliation). */
-export interface GetOrgReconciliationResponse {
+export interface GetOrgReconciliationResponse extends ReconciliationRunAttempts {
     runId: string;
     retailerId: string;
     entity: ReconciliationEntityEnum.STORES | ReconciliationEntityEnum.USERS;
@@ -22,7 +33,7 @@ export interface GetOrgReconciliationResponse {
     preview?: ReconciliationPreview;
 }
 /** Respuesta 200 de GET .../reconciliations/{runId} en catalog (backofficeGetCatalogReconciliation). */
-export interface GetCatalogReconciliationResponse {
+export interface GetCatalogReconciliationResponse extends ReconciliationRunAttempts {
     runId: string;
     retailerId: string;
     entity: ReconciliationEntityEnum.CATALOG | ReconciliationEntityEnum.INVENTORY | ReconciliationEntityEnum.MOVEMENTS;

package/package.json

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

package/src/retailIntegration/dtos/GetReconciliationResponses.ts

@@ -4,8 +4,20 @@ import type { ReconciliationTriggerEnum } from '../enums/ReconciliationTriggerEn
 import type { ReconciliationPreview } from './ReconciliationPreview';
 import type { ReconciliationRunCounts } from './ReconciliationRunCounts';
 
+/** Fallos de una corrida: por qué se abortó y en qué intento de SQS va la página que falla. */
+export interface ReconciliationRunAttempts {
+    /** Motivo del ABORTED (`MAX_ATTEMPTS`, `ROW_WITHOUT_ID`, el `code` del externo caído, etc.); null si no se abortó. */
+    abortReason?: string | null;
+    /** `code` del último error de la página en curso; null si la página no ha fallado. */
+    lastErrorCode?: string | null;
+    /** Intento de SQS (1-based) en que falló la página en curso; null si no ha fallado. */
+    attempt?: number | null;
+    /** Intentos de SQS que tiene una página antes de abortar la corrida. */
+    maxAttempts?: number;
+}
+
 /** Respuesta 200 de GET .../reconciliations/{runId} en org (backofficeGetOrgReconciliation). */
-export interface GetOrgReconciliationResponse {
+export interface GetOrgReconciliationResponse extends ReconciliationRunAttempts {
     runId: string;
     retailerId: string;
     entity: ReconciliationEntityEnum.STORES | ReconciliationEntityEnum.USERS;
@@ -24,7 +36,7 @@ export interface GetOrgReconciliationResponse {
 }
 
 /** Respuesta 200 de GET .../reconciliations/{runId} en catalog (backofficeGetCatalogReconciliation). */
-export interface GetCatalogReconciliationResponse {
+export interface GetCatalogReconciliationResponse extends ReconciliationRunAttempts {
     runId: string;
     retailerId: string;
     entity: ReconciliationEntityEnum.CATALOG | ReconciliationEntityEnum.INVENTORY | ReconciliationEntityEnum.MOVEMENTS;