@fiado/type-kit 3.619.0 → 3.621.0

package/_test_/unit/reconciliation/reconciliationRequests.test.ts

@@ -35,7 +35,8 @@ function errorsOf<T extends object>(cls: new () => T, payload: Record<string, un
     return validateSync(dto).map((e) => e.property);
 }
 
-const operator = { tenantId: 'surekeep', author: 'conciliacion-dashboard', actor: 'operador@fsa.mx' };
+const service = { tenantId: 'surekeep', author: 'conciliacion-dashboard' };
+const operator = { ...service, actorId: 'aZ3x9Qk-azure-ad-sub_01' };
 
 describe('definiciones', () => {
     it('configurar pide un estado válido y listas de sandbox opcionales', () => {
@@ -138,7 +139,7 @@ describe('resolución, reactivación y notas', () => {
 });
 
 describe('espejo privado', () => {
-    it('agrega tenantId, author y actor a la versión pública', () => {
+    it('agrega tenantId, author y actorId a la versión pública', () => {
         expect(
             errorsOf(PrivateResolveReconciliationItemRequest, {
                 ...operator,
@@ -150,7 +151,7 @@ describe('espejo privado', () => {
             type: ReconciliationResolutionTypeEnum.EXCLUDE,
             reason: 'prueba interna',
         });
-        expect(missing).toEqual(expect.arrayContaining(['tenantId', 'author', 'actor']));
+        expect(missing).toEqual(expect.arrayContaining(['tenantId', 'author', 'actorId']));
         expect(errorsOf(PrivateAddReconciliationItemNoteRequest, { ...operator, actor: 'no-es-correo', text: 'revisar con tesorería' })).toContain(
             'actor',
         );
@@ -167,11 +168,29 @@ describe('espejo privado', () => {
         expect(errorsOf(PrivateRunReconciliationRequest, { ...operator, definitionId: 'm8-gateway-bank', periodKey: '2026-10-29' })).toEqual(
             [],
         );
-        expect(errorsOf(PrivateGetReconciliationItemQuery, { tenantId: 'surekeep', author: 'x' })).toContain('actor');
+        expect(errorsOf(PrivateGetReconciliationItemQuery, { tenantId: 'surekeep', author: 'x' })).toContain('actorId');
         expect(errorsOf(PrivateListReconciliationItemsQuery, { ...operator, definitionId: 'm8-gateway-sofom' })).toEqual([]);
     });
 });
 
+describe('operador del espejo', () => {
+    it('viaja por actorId, que no puede ser un email; actor (email) es opcional', () => {
+        const { PrivateReconciliationOperatorCaller } = Reconciliation;
+        expect(errorsOf(PrivateReconciliationOperatorCaller, operator)).toEqual([]);
+        expect(errorsOf(PrivateReconciliationOperatorCaller, { ...operator, actor: 'operador@fsa.mx' })).toEqual([]);
+        expect(errorsOf(PrivateReconciliationOperatorCaller, service)).toContain('actorId');
+        expect(errorsOf(PrivateReconciliationOperatorCaller, { ...service, actorId: 'operador@fsa.mx' })).toContain('actorId');
+        expect(
+            errorsOf(PrivateResolveReconciliationItemRequest, {
+                ...service,
+                actorId: 'operador@fsa.mx',
+                type: ReconciliationResolutionTypeEnum.EXCLUDE,
+                reason: 'prueba interna',
+            }),
+        ).toContain('actorId');
+    });
+});
+
 describe('feed genérico de los dueños', () => {
     it('lista por tenant y ventana, con cursor opcional', () => {
         expect(

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/_test_/unit/transferNote/transferNoteConfigAndPrivate.test.ts

@@ -30,7 +30,8 @@ function errorsOf<T extends object>(cls: new () => T, payload: Record<string, un
 }
 
 const service = { tenantId: 'surekeep', author: 'conciliacion-dashboard' };
-const caller = { ...service, actor: 'operador@fsa.mx' };
+const actorId = 'aZ3x9Qk-azure-ad-sub_01';
+const caller = { ...service, actorId };
 const longReason = 'emisión manual por corte fallido del lunes';
 
 describe('UpdateTransferNoteConfigRequest', () => {
@@ -97,12 +98,15 @@ describe('UpdateTransferNoteConfigRequest', () => {
 });
 
 describe('espejo privado', () => {
-    it('agrega tenantId, author y actor a la versión pública', () => {
+    it('agrega tenantId, author y actorId a la versión pública', () => {
         expect(errorsOf(PrivateIssueTransferNoteRequest, { ...caller, pairKey: 'p-1', isoWeek: '2026-W43', reason: longReason })).toEqual([]);
         expect(errorsOf(PrivateIssueTransferNoteRequest, { pairKey: 'p-1', isoWeek: '2026-W43', reason: longReason })).toEqual(
-            expect.arrayContaining(['tenantId', 'author', 'actor']),
+            expect.arrayContaining(['tenantId', 'author', 'actorId']),
         );
         expect(errorsOf(PrivateIssueTransferNoteRequest, { ...caller, actor: 'operador', pairKey: 'p-1', isoWeek: '2026-W43', reason: longReason })).toContain('actor');
+        expect(
+            errorsOf(PrivateIssueTransferNoteRequest, { ...caller, actorId: 'operador@fsa.mx', pairKey: 'p-1', isoWeek: '2026-W43', reason: longReason }),
+        ).toContain('actorId');
         expect(
             errorsOf(PrivateCaptureTransferNoteSpeiRequest, {
                 ...caller,
@@ -113,21 +117,32 @@ describe('espejo privado', () => {
         ).toEqual([]);
     });
 
-    it('las lecturas privadas también exigen author y actor', () => {
+    it('las lecturas privadas también exigen author y actorId', () => {
         expect(errorsOf(PrivateGetTransferNoteQuery, caller)).toEqual([]);
-        expect(errorsOf(PrivateGetTransferNoteQuery, { tenantId: 'surekeep' })).toEqual(expect.arrayContaining(['author', 'actor']));
+        expect(errorsOf(PrivateGetTransferNoteQuery, { tenantId: 'surekeep' })).toEqual(expect.arrayContaining(['author', 'actorId']));
         expect(errorsOf(PrivateListTransferNotesQuery, { ...caller, limit: '20' })).toEqual([]);
     });
 
-    it('confirm-settlement pide el caller con el email del operador', () => {
+    it('confirm-settlement pide el caller con el id del operador', () => {
         expect(errorsOf(PrivateConfirmTransferNoteSettlementRequest, caller)).toEqual([]);
-        expect(errorsOf(PrivateConfirmTransferNoteSettlementRequest, service)).toContain('actor');
+        expect(errorsOf(PrivateConfirmTransferNoteSettlementRequest, service)).toContain('actorId');
+    });
+
+    it('el operador viaja por actorId; actor (email) es opcional', () => {
+        const { PrivateTransferNoteOperatorCaller } = TransferNote;
+        expect(errorsOf(PrivateTransferNoteOperatorCaller, caller)).toEqual([]);
+        expect(errorsOf(PrivateTransferNoteOperatorCaller, { ...caller, actor: 'operador@fsa.mx' })).toEqual([]);
+        expect(errorsOf(PrivateTransferNoteOperatorCaller, service)).toContain('actorId');
+        expect(errorsOf(PrivateTransferNoteOperatorCaller, { ...service, actorId: '' })).toContain('actorId');
+        expect(errorsOf(PrivateTransferNoteOperatorCaller, { ...service, actorId: 'operador@fsa.mx' })).toContain('actorId');
+        expect(errorsOf(PrivateTransferNoteOperatorCaller, { ...service, actorId: 'x'.repeat(129) })).toContain('actorId');
+        expect(errorsOf(PrivateTransferNoteOperatorCaller, { ...caller, actor: 'no-es-correo' })).toContain('actor');
     });
 
     it('el corte manual pide tenant, semana y author', () => {
         expect(errorsOf(PrivateRunTransferNoteCutoffRequest, { ...service, isoWeek: '2026-W43' })).toEqual([]);
         expect(errorsOf(PrivateRunTransferNoteCutoffRequest, { ...service, isoWeek: 'W43' })).toContain('isoWeek');
-        expect(Object.keys(plainToInstance(PrivateRunTransferNoteCutoffRequest, caller, { excludeExtraneousValues: true }))).not.toContain('actor');
+        expect(Object.keys(plainToInstance(PrivateRunTransferNoteCutoffRequest, caller, { excludeExtraneousValues: true }))).not.toContain('actorId');
     });
 
     it('el ajuste es idempotente por adjustmentKey y lleva monto entero distinto de cero', () => {

package/bin/reconciliation/dtos/requests/PrivateReconciliationRequests.d.ts

@@ -5,9 +5,12 @@ export declare class PrivateReconciliationCaller {
     tenantId: string;
     author: string;
 }
-/** Caller del espejo que llama fiado-dashboard; `actor` es el email del operador de la sesión. */
+/** Caller del espejo que llama fiado-dashboard; el operador viaja por `actorId`. */
 export declare class PrivateReconciliationOperatorCaller extends PrivateReconciliationCaller {
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Query de privateGetReconciliationItem. */
 export declare class PrivateGetReconciliationItemQuery extends PrivateReconciliationOperatorCaller {
@@ -16,65 +19,98 @@ export declare class PrivateGetReconciliationItemQuery extends PrivateReconcilia
 export declare class PrivateListReconciliationDefinitionsQuery extends ListReconciliationDefinitionsQuery {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateConfigureReconciliationDefinition. */
 export declare class PrivateConfigureReconciliationDefinitionRequest extends ConfigureReconciliationDefinitionRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Query de privateListReconciliationRuns. */
 export declare class PrivateListReconciliationRunsQuery extends ListReconciliationRunsQuery {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateRunReconciliation: responde 202 con `runId`. */
 export declare class PrivateRunReconciliationRequest extends RunReconciliationRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Query de privateGetReconciliationMatrix. */
 export declare class PrivateGetReconciliationMatrixQuery extends GetReconciliationMatrixQuery {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Query de privateGetReconciliationOverview. */
 export declare class PrivateGetReconciliationOverviewQuery extends GetReconciliationOverviewQuery {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Query de privateGetReconciliationSummary. */
 export declare class PrivateGetReconciliationSummaryQuery extends GetReconciliationSummaryQuery {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Query de privateListReconciliationItems. */
 export declare class PrivateListReconciliationItemsQuery extends ListReconciliationItemsQuery {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateResolveReconciliationItem. */
 export declare class PrivateResolveReconciliationItemRequest extends ResolveReconciliationItemRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateReactivateReconciliationItem. */
 export declare class PrivateReactivateReconciliationItemRequest extends ReactivateReconciliationItemRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateAddReconciliationItemNote. */
 export declare class PrivateAddReconciliationItemNoteRequest extends AddReconciliationItemNoteRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }

package/bin/reconciliation/dtos/requests/PrivateReconciliationRequests.js

@@ -25,12 +25,16 @@ __decorate([
     (0, reconciliationRequestDecorators_1.RequiredId)(),
     __metadata("design:type", String)
 ], PrivateReconciliationCaller.prototype, "author", void 0);
-/** Caller del espejo que llama fiado-dashboard; `actor` es el email del operador de la sesión. */
+/** Caller del espejo que llama fiado-dashboard; el operador viaja por `actorId`. */
 class PrivateReconciliationOperatorCaller extends PrivateReconciliationCaller {
 }
 exports.PrivateReconciliationOperatorCaller = PrivateReconciliationOperatorCaller;
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateReconciliationOperatorCaller.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateReconciliationOperatorCaller.prototype, "actor", void 0);
 /** Query de privateGetReconciliationItem. */
@@ -50,7 +54,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateListReconciliationDefinitionsQuery.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateListReconciliationDefinitionsQuery.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateListReconciliationDefinitionsQuery.prototype, "actor", void 0);
 /** Body de privateConfigureReconciliationDefinition. */
@@ -66,7 +74,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateConfigureReconciliationDefinitionRequest.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateConfigureReconciliationDefinitionRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateConfigureReconciliationDefinitionRequest.prototype, "actor", void 0);
 /** Query de privateListReconciliationRuns. */
@@ -82,7 +94,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateListReconciliationRunsQuery.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateListReconciliationRunsQuery.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateListReconciliationRunsQuery.prototype, "actor", void 0);
 /** Body de privateRunReconciliation: responde 202 con `runId`. */
@@ -98,7 +114,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateRunReconciliationRequest.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateRunReconciliationRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateRunReconciliationRequest.prototype, "actor", void 0);
 /** Query de privateGetReconciliationMatrix. */
@@ -114,7 +134,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateGetReconciliationMatrixQuery.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateGetReconciliationMatrixQuery.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateGetReconciliationMatrixQuery.prototype, "actor", void 0);
 /** Query de privateGetReconciliationOverview. */
@@ -130,7 +154,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateGetReconciliationOverviewQuery.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateGetReconciliationOverviewQuery.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateGetReconciliationOverviewQuery.prototype, "actor", void 0);
 /** Query de privateGetReconciliationSummary. */
@@ -146,7 +174,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateGetReconciliationSummaryQuery.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateGetReconciliationSummaryQuery.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateGetReconciliationSummaryQuery.prototype, "actor", void 0);
 /** Query de privateListReconciliationItems. */
@@ -162,7 +194,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateListReconciliationItemsQuery.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateListReconciliationItemsQuery.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateListReconciliationItemsQuery.prototype, "actor", void 0);
 /** Body de privateResolveReconciliationItem. */
@@ -178,7 +214,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateResolveReconciliationItemRequest.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateResolveReconciliationItemRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateResolveReconciliationItemRequest.prototype, "actor", void 0);
 /** Body de privateReactivateReconciliationItem. */
@@ -194,7 +234,11 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateReactivateReconciliationItemRequest.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateReactivateReconciliationItemRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateReactivateReconciliationItemRequest.prototype, "actor", void 0);
 /** Body de privateAddReconciliationItemNote. */
@@ -210,6 +254,10 @@ __decorate([
     __metadata("design:type", String)
 ], PrivateAddReconciliationItemNoteRequest.prototype, "author", void 0);
 __decorate([
-    (0, reconciliationRequestDecorators_1.RequiredEmail)(),
+    (0, reconciliationRequestDecorators_1.RequiredActorId)(),
+    __metadata("design:type", String)
+], PrivateAddReconciliationItemNoteRequest.prototype, "actorId", void 0);
+__decorate([
+    (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateAddReconciliationItemNoteRequest.prototype, "actor", void 0);

package/bin/reconciliation/dtos/requests/reconciliationRequestDecorators.d.ts

@@ -1,7 +1,5 @@
-export { PageLimit, PageToken, RequiredEmail, RequiredId, RequiredReason } from '../../../transferNote/dtos/requests/transferNoteRequestDecorators';
+export { OptionalEmail, PageLimit, PageToken, RequiredActorId, RequiredEmail, RequiredId, RequiredReason } from '../../../transferNote/dtos/requests/transferNoteRequestDecorators';
 /** Periodo obligatorio: día, semana ISO o mes. */
 export declare function PeriodKey(): PropertyDecorator;
 /** Texto de 10+ caracteres sin contar espacios de relleno. */
 export declare function NoteText(): PropertyDecorator;
-/** Email opcional. */
-export declare function OptionalEmail(): PropertyDecorator;

package/bin/reconciliation/dtos/requests/reconciliationRequestDecorators.js

@@ -1,15 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RequiredReason = exports.RequiredId = exports.RequiredEmail = exports.PageToken = exports.PageLimit = void 0;
+exports.RequiredReason = exports.RequiredId = exports.RequiredEmail = exports.RequiredActorId = exports.PageToken = exports.PageLimit = exports.OptionalEmail = void 0;
 exports.PeriodKey = PeriodKey;
 exports.NoteText = NoteText;
-exports.OptionalEmail = OptionalEmail;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const reconciliationValidation_1 = require("../../constants/reconciliationValidation");
 var transferNoteRequestDecorators_1 = require("../../../transferNote/dtos/requests/transferNoteRequestDecorators");
+Object.defineProperty(exports, "OptionalEmail", { enumerable: true, get: function () { return transferNoteRequestDecorators_1.OptionalEmail; } });
 Object.defineProperty(exports, "PageLimit", { enumerable: true, get: function () { return transferNoteRequestDecorators_1.PageLimit; } });
 Object.defineProperty(exports, "PageToken", { enumerable: true, get: function () { return transferNoteRequestDecorators_1.PageToken; } });
+Object.defineProperty(exports, "RequiredActorId", { enumerable: true, get: function () { return transferNoteRequestDecorators_1.RequiredActorId; } });
 Object.defineProperty(exports, "RequiredEmail", { enumerable: true, get: function () { return transferNoteRequestDecorators_1.RequiredEmail; } });
 Object.defineProperty(exports, "RequiredId", { enumerable: true, get: function () { return transferNoteRequestDecorators_1.RequiredId; } });
 Object.defineProperty(exports, "RequiredReason", { enumerable: true, get: function () { return transferNoteRequestDecorators_1.RequiredReason; } });
@@ -29,11 +30,3 @@ function NoteText() {
         (0, class_validator_1.MinLength)(reconciliationValidation_1.RECONCILIATION_MIN_NOTE_LENGTH)(target, key);
     };
 }
-/** Email opcional. */
-function OptionalEmail() {
-    return (target, key) => {
-        (0, class_transformer_1.Expose)()(target, key);
-        (0, class_validator_1.IsOptional)()(target, key);
-        (0, class_validator_1.IsEmail)()(target, key);
-    };
-}

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/bin/transferNote/constants/transferNoteValidation.d.ts

@@ -5,3 +5,5 @@ export declare const TRANSFER_NOTE_ISO_WEEK_PATTERN: RegExp;
 /** CLABE interbancaria de 18 dígitos. */
 export declare const TRANSFER_NOTE_CLABE_PATTERN: RegExp;
 export declare const TRANSFER_NOTE_MAX_PAGE_SIZE = 100;
+/** Largo máximo del id del operador (`sub` de Azure AD). */
+export declare const TRANSFER_NOTE_ACTOR_ID_MAX_LENGTH = 128;

package/bin/transferNote/constants/transferNoteValidation.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TRANSFER_NOTE_MAX_PAGE_SIZE = exports.TRANSFER_NOTE_CLABE_PATTERN = exports.TRANSFER_NOTE_ISO_WEEK_PATTERN = exports.TRANSFER_NOTE_MIN_REASON_LENGTH = void 0;
+exports.TRANSFER_NOTE_ACTOR_ID_MAX_LENGTH = exports.TRANSFER_NOTE_MAX_PAGE_SIZE = exports.TRANSFER_NOTE_CLABE_PATTERN = exports.TRANSFER_NOTE_ISO_WEEK_PATTERN = exports.TRANSFER_NOTE_MIN_REASON_LENGTH = void 0;
 /** Largo mínimo de la razón de una emisión manual y de una objeción. */
 exports.TRANSFER_NOTE_MIN_REASON_LENGTH = 20;
 /** Semana ISO `YYYY-Www`, p. ej. `2026-W43`. */
@@ -8,3 +8,5 @@ exports.TRANSFER_NOTE_ISO_WEEK_PATTERN = /^\d{4}-W(0[1-9]|[1-4]\d|5[0-3])$/;
 /** CLABE interbancaria de 18 dígitos. */
 exports.TRANSFER_NOTE_CLABE_PATTERN = /^\d{18}$/;
 exports.TRANSFER_NOTE_MAX_PAGE_SIZE = 100;
+/** Largo máximo del id del operador (`sub` de Azure AD). */
+exports.TRANSFER_NOTE_ACTOR_ID_MAX_LENGTH = 128;

package/bin/transferNote/dtos/requests/PrivateTransferNoteRequests.d.ts

@@ -6,45 +6,66 @@ export declare class PrivateTransferNoteCaller {
     tenantId: string;
     author: string;
 }
-/** Caller del espejo que llama fiado-dashboard; `actor` es el email del operador de la sesión. */
+/** Caller del espejo que llama fiado-dashboard; el operador viaja por `actorId`. */
 export declare class PrivateTransferNoteOperatorCaller extends PrivateTransferNoteCaller {
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privatePreviewTransferNote. */
 export declare class PrivatePreviewTransferNoteRequest extends PreviewTransferNoteRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateIssueTransferNote. */
 export declare class PrivateIssueTransferNoteRequest extends IssueTransferNoteRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateCaptureTransferNoteSpei. */
 export declare class PrivateCaptureTransferNoteSpeiRequest extends CaptureTransferNoteSpeiRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateRevertTransferNoteSpei. */
 export declare class PrivateRevertTransferNoteSpeiRequest extends RevertTransferNoteSpeiRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateCancelTransferNote. */
 export declare class PrivateCancelTransferNoteRequest extends CancelTransferNoteRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateResolveTransferNoteDispute. */
 export declare class PrivateResolveTransferNoteDisputeRequest extends ResolveTransferNoteDisputeRequest {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateConfirmTransferNoteReception. */
 export declare class PrivateConfirmTransferNoteReceptionRequest extends PrivateTransferNoteOperatorCaller {
@@ -71,19 +92,28 @@ export declare class PrivateGetTransferNotePdfQuery extends PrivateTransferNoteO
 export declare class PrivateListTransferNotesQuery extends ListTransferNotesQuery {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Query de privateListTransferNotePool. */
 export declare class PrivateListTransferNotePoolQuery extends ListTransferNotePoolQuery {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Query de privateListTransferNoteItems. */
 export declare class PrivateListTransferNoteItemsQuery extends ListTransferNoteItemsQuery {
     tenantId: string;
     author: string;
-    actor: string;
+    /** `sub` de Azure AD del operador del dashboard. */
+    actorId: string;
+    /** @deprecated Solo para la auditoría de loan-retail-audit. */
+    actor?: string;
 }
 /** Body de privateRunTransferNoteCutoff: responde 202 con `runId` y corre asíncrono. */
 export declare class PrivateRunTransferNoteCutoffRequest extends PrivateTransferNoteCaller {